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(57) Abstract: A method and system is disclosed 
herein for execution of a computer program in 
which multimedia presentations, such as full-screen 
broadcast quality video, can be provided on a user's 
computer. The computer program is arranged 
to decode/decompress associated media data and 
display the media content regrdless what video 
decoding and/or playback software may or may not 
be installed on the user's computer, thus enabling 
substantially universal access by user's to the 
multimedia presentations. The computer program 
and media data files may be distributed on the 
computer readable compact discs (CD-ROM's), for 
example, and the computer program is adapted to 
execute on the user's computer without requiring 
installation under the computer operating system. 
The media data files may be encoded such that a 
digital key or the like is required in order in order 
to decode the media data for playback, such that a 
media data file may only be played using a specific 
version of the program, or by provision of the 
digital key by way of user input or through a digital 
communications network such as the internet or a 
corporate intranet 
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Method and System for Computer Software Application Execution 



Field of the Invention 

This invention relates to the execution of computer software applications, and 
5 in particular to software application execution on a computer independent of operating 
system environment constraints. 

Background of the Invention 

A typical general purpose computing system utilises several layers of control 

10 over the computing system resources in order to process information in response to commands 
from a computer user. For example, a basic input/output system (BIOS) provides a framework 
enabling an operating system (OS) to control the hardware components of the computer. Tine 
operating system, in turn, provides a framework enabling software applications to be executed 
on the computer using the computer hardware resources. Generally, a software application 

15 must be "installed" in the operating system to enable the operating system to allocate computer 
resources without conflict amongst various applications. 

The operating system layer keeps record of the installed applications in a 
catalogue that holds information enabling the operating system to determine if a requested 

20 software application is installed and available, and points the operating system to instructions 
allowing the application to be executed. On a computer with a Microsoft Windows operating 
system, this catalogue information is contained in what is referred to as the "registry". 
Essentially the registry is a cental database that stores information relating to hardware, system 
settings and application configurations. Some of the entries in the registry are referred to as 

25 Dynamic Link Libraries, which represent links to actual program commands. When a software 
application is installed under the Windows operating system, the installation process typically 
includes commands that add specific files to the registry so that the software can be recognised 
and processed by the operating system at the time of execution. 
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In many computing environments, such as corporate computer networks and 
the like, systems and network administrators often desire to maintain a standard operating 
environment (SOE) amongst the numerous computers. For example, each computer would 
typically have the same operating system configuration and be provided with the same set of 

5 installed software applications. In this way, each of the numerous computers can be 
maintained in a stable set-up configuration, which is known to the administrator enabling 
simplified troubleshooting procedures. The Windows operating system caters for this 
administration procedure by providing a security feature that allows system administrators to 
prevent ordinary computer users from modifying a SOE. One of the ways in which this is 

10 achieved is by preventing an ordinary computer user (i.e. a computer user without system 
administrator privileges) from modifying the operating system registry on the computer. 
Without the capability of modifying the system registry, in many cases the USeT is unable to run 
previously uninstalled software because die operating system is unable to obtain instructions 
regarding the existence of the software and the location of the program code. The result is that 

j 5 the ordinary computer user is prevented from installing new software on the computer. In most 
cases this is what the system administrator desires - the maintenance of the known stable 
computer software and operating system configuration and the prevention of software 
installations made without the administrator's compliance. This avoids software instability 
problems from being introduced to the computer from user initiated software installations 

20 causing operating system conflicts with other applications, and similar problems which are 
known to occur. 

A result of the computer administration practice described above is that a 
computer user may not be able to access certain files and programs without assistance from the 
25 system administrator. For example, if a computer user receives a file in a data format requiring 
a computer program not installed on that computer, the user is unable to access the file without 
installing the program. Assuming the computer program is available for installation, the file 
cannot be accessed without the assistance of the system administrator. 
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Even for computer users not constrained by the limitations of an enforced SOE, 
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accessing new files can still cause significant difficulties. Jf the user's computer does not have 
the necessary software to access the desired file, that software must be installed. The 
installation can be a time consuming process, and may result in system instability. Therefore, 
it may be considered too much trouble to install the program if the software will not be used 
5 often and the file access is not crucial. Further, the required software may not even be easily or 
immediately available to the user for installation. 

One of the fields in which the above described difficulties currently represent a 
significant impediment is in the distribution and presentation of multimedia data that may bo 
1 0 provided to a user on a compact disk (CD) or the like. 

Summary of the Invention 

In accordance with the present invention, there is provided a method for 
providing multimedia presentation by way of a computer processing and display apparatus 

15 having a data reading device for reading data from a removable digital data storage carrier, 
such as an optical data storage disk or the like, wherein a removable data storage carrier is 
provided having stored thereon at least one multimedia content data file in a compressed 
format, together with computer program code for execution on the computer processing and 
display apparatus and adapted for decompression of the at least one multimedia content data 

20 file and presentation of the multimedia content on the computer processing and display 
apparatus, wherein the computer program code provided with the multimedia content data file 
on the removable data storage carrier includes a data decompression module adapted to 
decompress the associated multimedia content data file and a multimedia player module that 
receives decompressed data from the decompression module and presents corresponding 

25 multimedia content for output by way of the computer apparatus hardware, whereby the 
multimedia content of the associated data file is presented by the computer apparatus hardware 
through use of the computer program code upon insertion of the removable data storage carrier 
in the data reading device and execution of the computer program code. 
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In a preferred implementation of the invention, the decompression and player 
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prograin code modules are executable on the computer processing and display apparatus 
without requiring installation with the computer operating system. Preferably the player 
program module interacts directly with the decompression module and a hardware abstraction 
layer (HAL) of the computer operating system. In the case of a Windows™ operating system 
5 computer, for example, this allows the player program module to effect presentation of the 
multimedia content from the removable data storage carrier on the computer without reference 
to the operating system regis&y. 

In another implementation of the invention, die multimedia content data file, 
io which may represent video footage such as a movie for example, is coded with a digital key or 
the like such that decompression/decoding and/or playing of the multimedia content is only 
possible with decompression and/or player program having a corresponding decoding key. 
The decoding key may be incorporated into the decompression/player program module(s) 
provided with the multimedia content data file, or may be provided separately for input by the 
15 user or by way of a computer communications network such as the internet or a corporate 
intranet, for example. 

One application of the invention involves at least one compressed multimedia 
content data file, such as a movie, provided on a CD, DVD or the like together with the 

20 decompression/player program code which is executable on a computer apparatus without 
installation with the computer operating system. The at least one data file is encoded with a 
digital key such that decompression and playing of the multimedia content is only possible 
using the decompression/player program code with the provision of a corresponding decode 
key. This allows the CD or DVD stored with the multimedia content to be distributed free of 

25 charge, for example, but only playable by the user upon provision of the decode key. The 
decode key may be made available to the user through an internet site, for example, contingent 
upon payment of a viewing fee which could be made by a credit card transaction or other 
suitable payment system. The decode key may be specific to a single data file or applicable to 
a plurality of data files. Furthermore, the player/decompression program code may be adapted 

30 to interpret the decode key as being applicable for a limited number of presentations of the 
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multiniedia content or for a limited time period. The decode key may also be operative only 
with the particular decompression/player program that is provided with the data file, such that 
the data file can only be played with the particular decompression/player software and with the 
provision of the decode key. Further, the player program may be constructed such that a 
5 decode key needs to be provided from an external source, such as an internet site, several times 
during the course of the data file content playback, which can facilitate prevention of the same 
key being used simultaneously for multiple playbacks at different sites* 

The present invention also provides a computer readable, removable digital 

10 data storage carrier having stored thereon at least one multimedia content data file in a 
compressed format together with computer program code for execution on a computer 
processing and display apparatus to decompress the at least one multimedia content data file 
and present the multimedia content on the computer processing and display apparatus, wherein 
the computer program code provided with the multimedia content data file on the removable 

15 data storage carrier includes a data decompression module adapted to decompress the 
associated multimedia content data file and a multimedia player module that, during execution 
on the computer apparatus, receives decompressed data from the decompression module and 
presents corresponding multimedia content for output by way of the computer apparatus 
hardware, whereby the multimedia content of the associated data file is presented by the 

20 computer apparatus hardware through use of the computer program code upon insertion of the 
removable data storage carrier in the data reading device and execution of the computer 
program code- 
Hie present invention further provides a computer having multimedia 

25 presentation capabilities operating under control of an operating system, in combination with a 
computer program that is executable on said computer to provide a multimedia presentation 
using an associated encoded media data file without requiring installation of the computer 
program with the operating system. 

30 The computer program is preferably provided stored on a removable data 
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storage carrier, such as an optical digital storage disk or the like, together with at least one 
associated encoded media data file. 

In a preferred implementation of the invention, the multimedia presentation 
5 comprises substantially full-screen broadcast quality video. 

The invention further provides a computer program in machine readable form 
and executable on a computer operating under control of an operating system, the computer 
program including a decoding program module for decoding media data from an associated 
10 encoded media data file, and a player program module for processing the decoded media data 
and controlling the computer to provide a video display presentation of the decoded media 
data, wherein the computer program is executable without requiring installation under the 
computer operating system. 

1 5 The computer program executable modules and at least one encoded media data 

file are preferably stored for distribution on a removable digital data storage carrier, such as a 
computer readable compact disk or the like. 

Other aspects and features of the various implementations of the present 
20 invention will become apparent from the following detailed description. 

Brief Description of the Drawings 

The invention is herein described, by way of example only, with reference to 
the accompanying drawings. With specific reference to the drawings in detail, it is stressed 

25 that the particulars shown are by way of example and for purposes of illustrative discussion 
of the preferred embodiments only, and are presented in the cause of providing what is 
believed to be the most useful and readily understood description of the principles and 
conceptual aspects of the invention. In this regard, no attempt is made to shown structural 
details of the invention in more detail than is necessary for a fundamental understanding of 

30 the invention, the description taken with the drawings making apparent to those skilled in the 
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art how the several forms of the invention may be implemented or embodied in practice. 
In the drawings: 

Figure 1 is a block diagram of functional components of a Windows computer 
environment arranged for playing video content according to a conventional method; 
5 Figure 2 is a functional block diagram of a computer system arranged to operate 

according to a first embodiment of the present invention; 

Figure 3 is a functional block diagram of a computer system arranged to operate 
according to a second embodiment of the invention; 

Figure 4 is a class diagram of software components utilised in implementation of an 
10 embodiment of the invention; 

Figure 5 is a flowchart diagram outlining the operating procedure of a first version 
of a media player according to an implementation of the invention, 

Figure 6 is a flowchart diagram outlining the operating procedure of a second 
version media player software program; 
15 Figure 7 is a flowchart diagram outlining the operating procedure of a third version 

media player software program; and 

Figure 8 is a flowchart diagram outlining the operating procedure of a fourth version 
media player software program. 

20 Detailed Description of the Preferred Embodiments 

The principles and operation of a method, system and computer software 
structure for computer software application execution according to the present invention may 
be better understood with reference to the drawings and accompanying description. 

25 Before explaining at least one embodiment of the invention in detail, it is to 

be understood that the invention is not limited in its application to the details of construction 
and arrangement of the components set forth in the following description or illustrated in the 
accompanying drawings. The invention is capable of other embodiments cr 
implementations or of being practiced or carried out in various ways which may not be 

30 specifically enumerated herein but can be readily ascertained from the explanation that is 
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provided. Also, it is to be understood that the specific nomenclature, phraseology and 
terminology employed herein is for the purposes of description and to provide a thorough 
understanding of the embodiments, and should not be regarded as limiting. 

5 For high quality video to appear to move smoothly it should be viewed at 

about 25 firames per second, or greater, and each frame of raw video data may be several 
hundred kilobytes in size. Thus, to present video for viewing so that it appears smoothly and 
of good image quality requires that the raw video data be provided to the displaying 
apparatus (e.g. a computer) at a very high rate. If that data is provided on a removable 

10 storage media such as a CD-ROM, the CD-ROM reader is required to read and convey the 
data to the computer processor at a high rate. Some CD-ROM readers are not capable of that 
performance, which is one of the reasons, why video data is compressed before storage. 
Another reason is simply to enable a reasonable amount of video footage to be stored on 
such removable storage media. In uncompressed form, an 8-minute digital video may be 

15 2000 MB, It must be compressed to less than 45 MB in order to fit onto a mini CD-ROM. 

Compression of a video file is achieved using video compression software, 
which produces a file of reduced size suitable for storage. The video is recovered from the 
compressed file using decompression software- The compression and decompression 
20 software is often referred to by the acronym "codec". The word codec is herein used to refer 
to the compression and decompression software components individually and collectively 
according to the context of the function required to be performed. 

Once the video file is compressed and stored on a CD-ROM, for example, it 
25 is then necessary for the recipient user's computer to decompress the file for playback. 
Conventionally the recipient computer must be installed with the same codec software for 
decompression as was used for the compression process of a given video file in order to 
effect playback. There are many forms of video codecs in use, and it is possible that a 
recipient's computer may not have the decompression codec required for a particular video 
30 file. Accordingly, at present although good compression/decompression software 
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technologies are available, few computer have adequate video codecs installed. This is 
particularly the case in the corporate environment, where there i$ general reluctance on the 
part of systems administrators to install non-work related software (such as video codecs) 
and where executives and staff arc prevented from installing their own software. In order to 
5 allow distribution and presentation of multimedia to a broad range of computer users, 
playback of video therein should therefore be possible regardless of whether or not the user's 
computer is installed with codec software, 

A product incorporating an embodiment of the present invention comprises a 

10 removable data storage medium recorded with multimedia video data together with 
executable code enabling the video presentation to be displayed on a computer operating 
under the Windows™ operating system independent of any video codec and/or player 
software that may be installed. This embodiment of the invention comprises software that 
can be included in a packet of digital information also containing compressed video that 

15 allows a recipient of the information packet to view the video without requiring the 
installation of any software on the recipient's computer. The software of the invention 
handles all the transactions that are normally handled by Windows in such a way that the 
files in the packet can be viewed using decompression and video player programs without 
those programs requiring installation and registration with the operating system. The packet 

20 of information will generally contain an auto-run routine, a video codec, a video data file, 
and a media player program. The media player program i$ modified as compared to a 
conventional media player suited for Windows in that all calls made to the decode library are 
altered in such a way that, instead of accessing the operating system registry in order to 
access the decoding capabilities of the video codec (e,g, openDivX), the codec is called 

25 directly thereby bypassing the Windows system registry. 

In one form of the invention, the packet of information is contained on a 
compact disk (CD-ROM), which may be a standard sized CD, a miniature CD or a business- 
card shaped CD. Alternatively, the information packet may be provided to the recipient on 
30 some other form of removable storage media, or can be provided to the user through a 
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coinputer communications network such as the internet or a corporate intranet, for example. 
A business card sized CD-ROM can store about 45 MB of data, which equates to around 8 
minutes of video when compressed. This provides a useful media my which to distribute 
and present corporate promotional video and multimedia presentations, for example, which 
5 is one field of application of embodiments of the invention. 

The software of the invention may also incorporate the implementation of an 
encryption mechanism, whereby only files encoded with an authorised 
compression/encoding process can be played by the user. This solution is broadly achieved 
using the following method. At the time of video production and encoding, the 
compression/encoding system generates a unique key that is encrypted and stored in the 
header of the video data file. This unique signature key requires a matching signature within 
the decoding and media playing software in order for the video file to be considered valid, 
and only then is playback of the video permitted. This can be used to prevent a user from 
attempting to play unauthorised video files, which have not been encoded with this unique 
key embedded in its header. In an extension of this method, the video file itself may be 
encrypted using the key prior to storage or transmission in the information packet. In 
essence, the video data file in the information packet must match the functional components 
(e.g. codec and media player) supplied with the video data in order for playback of the video 
to be permitted. 

Another modification incorporates the implementation of a web-based "lock 
and key" mechanism. This mechanism allows and end user to request (purchase) a key from 
a service provider by way of the internet in order to unlock and enable the decoder and 
25 player software to operate. The key provided may be specific to the player software itself, or 
may be unique to a particular media file r The media accessible to the user once the key has 
been obtained may be one or more media files provided initially with the player software, or 
may be provided through a computer communications networks such as the internet or a 
corporate intranet, for example. In this way, a CD could be provided to a user having the 
30 media player software of the present invention together with several media files of which 
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only a portion are viewable by the user without obtaining a key. The freely viewable files or 
file portions may constitute a preview of the material that is viewable with use of the key. 

Basically, users are required to enter a digital ID code ("key") to "unlock" the 
5 video content. Unique digital ID codes are distributed to users with the packaging or the like 
of the E-genie disk. Upon disk insertion, the E-genie player will begin playback of the video 
content, which will continue for a short period of time before the player program requests 
the user input the supplied digital key code. If a key code is entered by the user, the code is 
validated by consultation with an internet site storing a list of valid key code authorizations. 
10 A matching code "unlocks" the remaining video content and allows the video playback to 
continue, whereas no key code, or an' invalid key code entered by the user, results in the E- 
genie video playback being suspended. 

A procedure 200 including the lock an key functionality is illustrated in flow- 
15 diagram form in Figure 7, and described briefly below, When the E-genie disk is inserted 
into a user's computer CD drive (202) the E-genie player commences execution 
automatically (204) and plays video for a short period of time, say 30 seconds (206). The 
initial time period for video playback can be set in the E-genie player program before 
distribution, or at the time video playback commences by way of instructions from an E- 
20 genie internet site. After commencement of the video playback, the player program requests 
input from die user of the ID key code supplied with the E-genie disk (208). The digital 
code may be printed on packaging provided with the disk, or may be supplied to the user by 
the E-genie supplier by any convenient alternative means. The user is offered the option For 
the code to be stored on the computer for later use (212, 214), to avoid the user having to 
25 enter the code repeatedly. 

Upon a key code being entered by the user (210)> the player program attempts 
to validate the supplied code through communication with an internet site that holds a record 
of valid code numbers (216, 218). The validation data stored at the internet site may include 
30 a correspondence between valid ID codes and codes embedded into the E-genie player 
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software or content data, Such thai a match between such codes in respect of the user's 
playback instance is required in order to unlock the player for further video. In the event an 
invalid code or code correspondence is detected (216, 220), the user is informed of such 
occurrence at 222 whereupon the process restarts. A valid ID code detection (220) results in 

5 the E-genie internet server communicating with the E-genie player on the user's computer so 
as to periodically supply video keys to the player program (224). Whilst the E-genie video 
plays, the user's ID code remains valid, and the user's computer remains in communication 
with the internet, the player program periodically (e.g. each 30 seconds or some other 
definable time period) receives a video key code from the internet server, which key is 

10 required by the player program in order for the video playback to continue for the next time 
period. If the user's internet connection to the internet server is lost, the user is informed of 
such event, and the video playback is paused (226) until the connection can be re-established 
for validation of the user ID and supply of the video key codes. So long as the appropriate 
video key codes are supplied to the player program, the process 200 continues through steps 

15 228, 230, 232, 234, for example, which procedures are described in detail elsewhere in this 
document. 

A specific implementation of an embodiment of the present invention is 
described hereinafter in the context of a Windows™ environment computing system, which 

20 is the most prevalent among home and business computer users presently. This embodiment 
is concerned with the presentation of multimedia to a recipient user on their computer 
without regard to specific video codecs and/or media players that may or may not be 
installed on the recipient computer. By way of background, the operations and functions 
involved in playback of video content in a standard Windows environment is briefly 

25 described hereinbelow. 

A block diagram of the functional components of a computer system 10 
arranged for playing video content is show in Figure 1 and referred to hereinbelow in order 
to generally explain the operations involved in playing video content under a standard 
30 Windows environment. The video content data file is shown at 12 and may comprise, for 



WO 03/005190 



PCT/AU02/00922 



-13- 

example, a data file that represents a video clip in a compressed and encoded format. The 
video data is compressed and encoded for a number of reasons; one of which is to enable a 
longer length video clip to fit on a given fixed capacity storage medium. 

5 When the computer user requests that the video file 12 be played, a 

multimedia player program 14, which has been previously installed on the computer, is 
invoked with reference to the video file 12. The player software may comprise, for example, 
Windows Media Player, or the like. Having regard to information about the compression 
and encoding of the video file contained in the header thereof, for example, the player 

10 software queries the Windows System Registry 1 6 to determine if the computer has access to 
an appropriate decompression module. The system registry scans its entries for 
decompression software appropriate for the video file to identify a previously installed 
decompression module 18, such as DivX. The system registry then passes the 
decompression parameters for the valid decompression module back to the media player 14, 

15 and the player program instructs the decompressor to obtain video content data from the 
video file 12. Video content data is then passed from the video file 12 to the decompression 
module 18. The video data is decompressed/decoded and passed to the DirectX layer 20 of 
the Windows operating system. DirectX processes the decoded video data and passes video 
content to the computer hardware (22) whereupon it is displayed for the user. 

20 

By way of contrast, Figure 2 is a functional block diagram of a computer 
system 30 arranged to play video content according to an embodiment of the present 
invention, whereby the video content can be presented without requiring that the 
decompression and/or media player components needed to access the video file be 

25 previously entered in the Windows operating system registry. As can be seen in Figure 2, 
the video content file (32) is passed to a media player and decompression software package, 
referred to herein as an Egenie™ (34). The Egenie software 34 includes decompression 
software, in this case modified open source code DivX decompression module 36, and video 
player software 38, such as a modified version of the Playa program which is a media player 

30 associated with openDivX. In one preferred form of the invention the video content file 32 



WO 03/005190 



PCT/AU02/00922 



-14- 

and Egenie software 34 is contained together in an information packet 40, on a CD, DVD or 
other suitable digital media removable storage device. 

Upon a request for presentation of the video content, data from the video file 
5 32 is passed to the Egenie player 38, which may be invoked automatically upon insertion of 
the CD or the like into the computer drive, for example. The Egenie software is executed by 
the user's computer even though, a$ mentioned, it has not been installed and registered with 
the computer's Windows operating system. The Egenie player interacts with the Egenie 
decompression module, whereby the video content data is processed to obtain decompressed 
1 o video data. The decompressed video is passed from the Egenie software to the DirectX layer 
of the Windows operating system 42, which in turn presents the video data to the 
video/audio hardware of (he computer for display to the user. The Egenie software is able to 
present the video footage from the video content file 32 on the user's computer regardless of 
whether that computer is installed with an appropriate media player or decompression 
15 software. 

A functional block diagram of another computer system arrangement 50 is 
shown in Figure 3, where reference numerals in common with the arrangement in Figure 2 
denote like components. The arrangement 50 illustrates a system in which the video content 
20 media data 32 is separate from the E-genie product 34 containing the media player 38, video 
codec 36, and in this case a separate audio codec 37. 

An outline of a first version of the E-genie player operational procedure 150 
is depicted in flow-diagram form in Figure 5. This version of the player operating procedure 

25 corresponds substantially to the functions as described hereinabove, beginning with the 
insertion of an E-genie disk into the CD-ROM drive of a personal computer or the like 
(152). The E-genie player software stored on the disk commences execution on the 
computer automatically (154) by examining the corresponding video data file to determine if 
it is in condition to be played (156). For example, the video data file may be scanned to 

30 ensure that the data available is complete and imcorrupted. The E-gcnie player program then 
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queries the computer operating system to determine the display capabilities of the computer, 
in order to determine which of a plurality of display modes the player should utilise to make 
best effect of the computer resources whilst presenting a good video display to the user. The 
B-genie player selects the video display mode having the highest quality playback that is 
5 compatible with the resources of the computer (158). The E-gcnie player then proceeds to 
check that the relevant video data file contains a unique security signature indicating it is a 
valid and legitimate data file, and decrypts the video data from the file (160). The decrypted 
video data is then decompressed and presented for display on the computer screen for 
viewing by the user (162). Following completion of the playback, the user may indicate that 
10 the video should be played again (164). If not, the first version of the E-genie playback 
procedure 150 terminates. 

Another advantageous feature of the present invention allows the E-genie 
player software to obtain user preference information. In this configuration, the E-genie 

15 software utilises an internet connection to provide user information to a central web-site. 
For example, at the end of video presentation, and optionally upon the user's request, the 
player forwards details of itself (Application name and path) to the website, by opening a 
browser window with the website's URL, This allows a website to generate scripts to 
execute different stored media files on the client machine, in response to selecting options on 

20 a web page. This permits a "broadband" web site experience on a relatively slow 
communications connection, such as a 56k dialup modem link to the internet. The player is 
preferably also capable of detecting if an internet connection is present to enable such 
functions to be carried out 

25 A procedure 170 according to a second version of the E-genie player 

operation is illustrated in flow-diagram form in Figure 6. which includes the basic player 
functionality of procedure 150 with the addition of the web-hybrid function introduced 
above. In the web hybrid system 170, generally, the user is able to view a video display 
based on data contained on the E-genie disk, following which the user is offered a choice to 

30 "opt in" to view further video footage. If the user decides to opt in, a series of questions are 
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asked of the user and from the gathered information a form of user profde is built and 
retained by the E-genic provider. Based on the information gathered, video data is selected 
as appropriate for that user profile, and the most relevant video content (referred to a$ the 
"derived 11 video content) is presented to the user by the E-genie player. The derived video 
5 content is preferably stored on the E-genie disk possessed by the user, but may not be 
otherwise accessible except through the opt in procedure, 

Steps 172 to 180 of procedure 170 correspond to steps 152 to 160 of 
procedure 150 already discussed, and perform equivalent functions. Once the user is 

10 finished with viewing the displayed video content (1 84) the E-genie player presents the user 
with a choice of entering a competition or the like (186) in exchange for providing some 
personal information or survey answers (190, 192). If the user wishes to join the 
competition (186), the E-genie player software determines whether the computer has a 
connection to the internet (188). If an internet connection is found, the player software 

15 displays a questionnaire screen for completion by the user, which information is 
communicated immediately to the E-genie web-server (192). The user is then presented 
with a number of relevant choices from a web-page (194), to which the user provides 
choices on-line depending on preference (196). Upon completion, the E-genie player is 
provided with instructions or an unlocking code, for example, from the web-site which 

20 facilitates the player launching corresponding video from the E-gcnie disk in the user 
computer's CD-ROM drive. 

In a variation of this system, feedback from the E-genie player can be 
provided by email. For example, at the end of video presentation, and optionally upon the 

25 user's request, the E-genie player software executes a sub-program which collects user 
information and populates an email with the details the user has entered (190). The user 
then selects to submit this form and next time their email client connects to send and/or 
receive messages the form is submitted to the server. A separate extraction program tool 
executing on the server scans the received emails and extracts the submitted data which can 

30 subsequently be used for targeted marketing and the like. 
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Another development of the E-genie software enables provision of a web 
interactive E-genie player, having a network communications connection of the player to a 
web server that is presenting and/or collecting information. The functionality is as follows. 
The player software connects to the web server via direct connection (opening a socket) and 
via query strings. The two contain a unique key that permits linking of web session and 
player instance. An E-genie software application on the server communicates with the web 
server, and sends commands to the E-genie player to present video selected by way of the 
web page. 

A system of this form can be implemented using the following components: 

1. E-genie Player. 

The E-genie Player may function as follows. At the closing screen the player 
executes a web link, and hides in the background. The user is presented with the web 
page, and at the same time the player creates a direct connection to an application 
running on the web server. A unique number is generated, and passed by both query 
string and direct methods to enable the player to be "tied" to server, 

2. Web Server 

The web server communicates with the E-genie server application, as it 
requires to close the player, and to send it commands to present different footage. 

3. E-genie Application on Web Server. 

The E-genie server application communicates with the web server, and sends 
commands to the E-genie player when requested. If it fails to deliver a command, an 
error is reported and the web server defaults to the existing batch file download and 
execute method. The server application also checks if the initial instance of the E- 
genie player is still alive. 



4, Protocol. 
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A communications protocol to support the above system can be simple, 
containing error checking, correction, hijacking, spoofing and Denial of Service 
detection. It may also contain a flow of errors, if the player can't find a file, etc. 

5 A further extension of the E-genie software involves augmenting the 

functionality of the network feedback and adding interactive components to the video 
footage. The extended network functionality is based on the web feedback mechanism 
described above, but supporting additional functionality as follows: 

- Creation of a web session at the start of the media playback by the E-genie 
10 player. This can be performed with or without the user details (i,e, anonymous or 

known user); 

- A direct (internet) connection passes back lo the E-genie server application 
information on how the user is interacting with the video, based on what the user 
clicks, pauses, reviews, watches, etc; 

15 - Optional inclusion of User number information that allows Specific User 

preference information to be collected. (If completely anonymous or if user 
requested) 

Advantageously, a user interface data stream may also be incorporated into 
20 the E-genie media data to be played by the E-genie player. The user interface stream 
facilitates the use of "clickable" areas in the video display. These video areas (when 
selected with the mouse) cause a function to occur. The function invoked for a particular 
application may comprise a video control (see below), and/or execution of a web page, 
program or other method of user feedback, or presentation to the u$er. Highlighted and non- 
25 highlighted version may be provided, wherein highlighting of the "clickable" display area 
emphasises to the user the inherent functionality but may detract from the visual appeal of 
some video presentations. The forms of video controls which may be useful for this type of 
function include: video playback pause/restart, frame rate control, re-seeking control, re- • 
sizing control, and/or various sound controls. In this implementation of the invention, it is 
30 intended that the video playback display create the entire user interface for the user to 
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interact with and not just be a passive spectator. 

In this embodiment, essentially, users are able to click on areas of the video 
footage displayed by the E-genie player in order to instigate a response. The response may 
5 be in the form of the actions, mentioned by example only, such as: navigation to another 
location with in the video content being watched; overlaying information into the video 
stream so as to present intelligent advertising, user alerts, pricing information, retail product 
information, and the like. 

10 A procedure 250 according to a fourth version of the E-genie player operation 

is illustrated in flow-diagram form in Figure S, which includes the basic player functionality 
of procedure 150 with the addition of the video interaction function introduced above. The 
steps 252 to 264 shown in Figure 8 correspond to steps 152 to 164 of procedure 150. The 
procedure 250, however, further includes a user interactive layer (266) that allows the user to 

1 5 actuate "hot-spots" provided in the video display using the computer mouse, for example. 
The hot-spot areas in the video display may be present for the duration of the video 
playback, or may be actuable by the user only during timed correspondence with the 
appearance of certain images of the video content The E-genie player program detects the 
location and timing of the user's action to determine the function to be performed. 

20 

A specific implementation of the invention as outlined above involves the use 
of the Microsoft Windows application programming interface (API) called DirectX, that 
provides an interface for access to the vast array of different types of hardware associated 
with Intel based personal computers (PCs). By using DirectX, an application programmer is 
25 able to code a computer program to work on all forms of PC hardware, without having to 
write individual code for each possible hardware device that might exist, 

The E-gcnic implementation outlined above also makes use of the video 
codec called DivX.. which is presently one of the best available systems for compressing and 
30 decompressing video files. The open source code version of DivX (openDivX) is utilised, 
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modified as detailed below, in conjunction with the associated player referred to as Playa, 
The openDivX player is used to play video content that has been encoded by openDivX. It 
does this by using the decode library which utilises the openDivX decoding facilities, this 
decoded content is then displayed on the screen through the use of DirectX. OpenDivX and 

5 DirectX typically use the Windows system registry in order to function, and thus the player 
has been altered for the purposes of the E-genie software so that it does not require access to 
the registry. In particular, all calls made to the decode libraiy are modified in the E-genie 
player, so that instead of accessing the registry to access the decoding capabilities of 
OpenDivX, the openDivX decompression module is called directly hence bypassing the 

10 registry. 

This particular implementation is designed for the presentation of high quality 
video on the Windows desktop where the user does not necessarily have the DivX codec 
installed on their PC. The method incorporates the digital video content, DivX 

15 decompression software and a video media player into a single file, that may be delivered on 
(but by no means limited to) a mini CD-ROM, In order for this methodology to work, the 
source code for tine codec must be available, such that it can be incorporated into the E-genie 
file 40- There is no particular requirement that the codec used for the E-genie software be 
DivX, which was chosen simply because it facilitates high performance and the source code 

20 is available. In order to best take advantage of this method, the E-genie file 40 should also 
include a player, such that it is truly independent from all installed software. 

A class diagram 100 for the E-genie software implementation is illustrated in 
Figure 4, and represents all of the classes and methods used to develop the E-genie software. 
25 Hie interconnecting lines between each class illustrate the relationships and dependencies 
between these classes, in situ, as they are implemented. The various classes, methods and 
data types employed are described in detail hereinafter. 
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CLASS NAME: 
AudioCodec 

DESCRIPTION: 

AudioCodec handles all the audio codec management of the Egenie Player. It is capable of 
playing mp3 encoded audio stream. 

ATTRIBUTES; 

The Audio codec controls the included MP3 codec included with the Egenie player. It is 
responsible for getting compressed data from the AVI stream, and delivering decompressed 
data from the Audio codec to the AudioRenderer for generating audio output 

Structure for communicating with the mp3 decoder. 

struct mpstr mp 

Response from decompression codec. ' 

Int Iast_result 

int mpeg 
Amount fi> data actually used/decrypted 
int rea!_size 

Windows internal structure for holding WAV type information. 

WAVEFORMATEX * oFormat 

Pointer to the location of the media source class 

AviDecaps * decaps 

Memory structure for compressed data 

Char * in buffer 

Memory structure for decompressed data 

Char * outjmffer 

No remaining data to be read flag. 

boo! DeplctedMP3Data 

Milliseconds of time required to decode chunk of MP3 data. 

float TotalTimeForOneSecond 



METHODS: 



Method: 


AudioCodec(AviDecaps *decaps, WAVEFORMATEX *lpWave) 


Input: 


AviDecaps *decaps, WAVEFORMATEX *lpWave 


Output; 


None 


Description: 


AudioCodec constructor. Initializes all needed variables. 


Pseudocode: 


Initialise mpeg variable 
Initialise In_buf3fer variable 
Initialise outjjuffer variable 
Initialise oFormat variable 
Initialise lastjesult variable 
Initialise mp 

Mark Clock counter. 

If input lpWave= 1 

assign input decaps to class attribute decaps 
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Initialise tttd3 




This->las£ result = M~P3 NEED MORE 












rvuuvaiv intsirivry io output uuuvi 




IT rnpj is oecompressea CQirecuy 




cioaG ine mpj 




end if 




Write first chunk to output ring buffer. 




/ nuiicnng / 




while(ring isnt full) 




keep decompressing 1 




write to ring 




eud while 




set DepletedMP3Data to false 




set mpeg to J 




f* Set up the output format for the renderer */ 




allocate new memory and copy IpWave 




variable (oFormat) , 




copy IpWave into ©Format 




setup oFoimai variables exactly as IpWave 




check if bits per Sample is 8 or 16, if neither, set to 16 




check if channels is 1 or 2 if neither, set to 2 




end if 



5 



Method: 


-AudioCodecO 


Input: 


None 


Output: 


None 


Description: 


AudioCodcc Destructor. Cleans up memory associated with 
AudioCodec 


Pseudocode; 


CloseQ 

Safely delete input buffer 
Safely delete output buffer 
Safely delete format data. 




Method: 


BOOL IsOKO 


input! 


None 


Ontput: 


None 


Description: 


Return TRUE is codec is ready to decompress 


Pseudocode: 


If this->mpeg equals i 
Return TRUE 

End if 




Method: 


IntEmptyBuffersO 


Input: 


None 
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Output; 


Int 


Description; 


Empty all buffers 


Pseudocode: 


Initialise ring 

if its mpeg equals 1 

this^last/esult equals MP3_NEED_MORE 
exit the mp3 
Initialise the mp3 

End if 

Set DepletedMP3 to false. 

Refill the ring buffer with data, with while loop calling DecompressMP3. 
Write the decompressed Data to the Ring. 




Method; 


int DecompressMp3 0 


Input; 


None 


Output: 


int 


Description: 


Returns the status of the read operation 1 is good 0 is bad. 


Pseudocode: 


if MPS reading was ok by using lastj-esult 

decode MP3 data and place result in last_result 

If last__result was not need more data return 1 

Attempt to read a chunck of compressed audio from AVIdecaps, 

If full amount of data was returned, 1 

Pass read data to decompression software. 

Store return result in last_result 

Return SUCCESS 

Else 

If no eiTor was returned decode data. 
Return success 

End if 

else 

set variable ReadData equal to Result of ReadAudio 
if ReadData is -1 return Error 
if ReadData is 0 return 0 

set last_rcsu1t equal to result of call to decode MPS codec. 
Return Success 

end if 




Method: 


Int Decompre$s(void *buffer> int size) 


Input: 


Void *bufFer> int size 


Output: 


Tnt 


Description: 


decompress size octets of audio to buffer 


Pseudocode: 


if this is mpeg equals 1 
if size equals 0 return 0 
declare variable - int blocks equals size / 4096 

loop until i equals than blocks while 
ring not full and not DepletedMPSDala 
if decompress mp3 equals 1 
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write to ring 




else 




Set DepIetedMPSDara to true end if 




end while 




ReturnedBytes equate result of read ring into buffer 




If BytesRetumed not equal to 4096, return BytesRetumed 




increment i 




end loop 




return 0 



Method: 


Int CloseO 


Input: 


None 


Output; 


Int 


Description: 


Closes the decoding engine 


Pseudocode: 


If its mpeg 




exitmp3 




rnpeg = 0 




end if 




return 1 



Note: The Ring Read and write functions are not described here, as it involves a simple FIFO ring 
buffer, with under and overrun protection. 
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CLASS NAME: 
AudioRenderer 

DESCRIPTION: 

5 AudioRenderer handles all the audio capabilities of the egenie player. 

ATTRIBUTES: 

Variable for holding the volume. 
10 VolumeAmount 

Buffer handling variables for Direct Sound 

g^dwBufferSize 

g_dwLastPos 

gjiwNextWriteOffset 
15 g^dwProgress 

g^dwProgressOffset 

g^bPoundEnd 

Handle to Audio Codec for obtaining Decompressed Data 
ACodec 

20 Variable to hold temporary division for data saving. 

g AndioTuneDivsor 

Thread state variables 

Thread Dead 

WaitlngThread 
25 Paused state variable 

IsPaused 

Synchronising variables 

LastPlayed 

Tested 

3 0 Volume Control Failure State 

NoVolumeControl 
Windows System Windows Variable 
hWnd 

Time between buffer updates 
3 5 gdwNotifyTimc 

Error handling variables 

ErrorCode 

ErrorMessage 

Windows System variables for handling threads 
40 AudioCallbackHandle 

DirectSoundMutex 

Device detection variables, • 

AudioDriverGUrDs 

dwAudioDriverlndex 
45 Direct Sound Interface variables 

g_»DS 

g pDSBuffer 

MediaStreamData 
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METHODS; 



Method: 


AudioRenderer(WAVEFORMATEX *inFormat, HWND hwnd) 


Input; 


volume 




None 


Description: 


AudioRender constructor 


Pseudocode: 


Initialise gjpDS 
Initialise ft pDSBuffcr 
Initialise ErrorCode 
Initialise ErrorMessage 
Initialise DircctSoundMutex 
Initialise ACodec 
Initialise WaitingThread 
Initialise ThreadDead 
Initialise dwAudioDriverlndex 
Initialise AudioCallbackHandle 
Initialise IsPaused 
Initialise LastPlayed 
Initialise Tested 

Initialise VolumeAmount to previous volume | 
Initialise NoVolumeControi to false 
Initialise g dwProgressOfFset 




Method: 


-AudioRenderer() 


Input: 


None 


Output! 


None 


Description: 


Default Destructor. - used to be free direct Sound. 


Pseudocode; 


Call SafeExit 




Method: 


Void SafeExit(void) 


Input: 


None 


Output: 


None 


Description: 


Destroys all variables 


Pseudocode: 


If AudioThread exists 

if thread is not dead then set WaitingThread to 1 
while Waiting for the Thread 
sleep 10 milliseconds 
increment counter 

if counter equals 1 0 then call resume thread, I 

just in case it was paused. 
If counter is greater that 20 

Forcibly terminate thread 

Break from loop 

End if 
End While 

End if 

Destroy die Thread Handle 
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Destroy the Mutex object 






Release DireciSound interfaces 






Release COM object 





Method: 


void HandleError(char * WindowTitle) 


Input: 


char* 


Output; 


void 


Description: 


This function advises the user of a fault and then exits. 


Pseudocode: 


Call SafeExit 

Tell the user about the fault 




Method: 


int lnitDirectSound( HWND hDlg .void * base, AudioCodec * 
Codec) 


Input: 


HWND, void *, AudioCodec * 


Output; 


Int 


Description; 


Initilises DirectSound 


Pseudocode: 


Initialise COM 
if fail return 

Enumerate Available Direct Sound Devices. 

If fail return 1 

If no drivers are available return a failure. 

Create IDirectSound using the primary sound device 

If fail return 

Set coop level to DSSCL_PRlORITY 
If fail return 

Set up variables for the primary buffer. 
Get the primary buffer 
If fail return 

Grab the primary sound buffer, and make our sound buffer always play 
If fail return 

Attempt to get the primary sound buffer for setting the audio mode 
If fail return 

Create the Mutex for accessing the direct sound. 

Check for mutex errors, if fail return. 

Create a thread to handle the audio callback. 

If fail return 

Set paused to true. 

Return successful. 




Method: 


int AudioRenderer::SetVolume(VolumeSet) 


Input; 


Enum Up or Down 


Ouput: 


Int 


Description: 


Increments or decrements the volume control on the users 
request 


Pseudocode: 


If No Volume Control is available return 
If there is no buffer to control return 
If (volume is to increase) 
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Set VolumeAmount = VolutneAmoiint + 200 




If Volume Amount is greater than max volume then 




Set Volume to max 




End if 




Call Set volume 




If error then return 1 




Return 0 




End if 




If (volume is to decrease) 




Set Volume Amount = VolumeAmount - 200 




If VolumeAmount is less than min volume then 




Set Volume to min 




End if 




Call Set volume 




If error then return 1 




Return 0 




End if 



Method: 


int AudioRenderer: :CreateStreamingBuffer(void) 


Input: 


void 


Ouput; 


int 


Description; 


Creates a streaming buffer, and the notification events to 
handle filling it as sound is played 


Pseudocode: 


This samples works by dividing a 132k buffer into 

AUDIOBUFFERNOTJFYSEGMENTS (or 16) piece?. 

Set up a windows timer that works through the windows event handling function 

and calls the AudioCallback function. 

Set g_dwNotifyTime to ms of playing time per buffer segment 

Set g_AudioTinieDivsor to floating point calculation to prevent in loop 

calculations. 

Allocate a sound buffer descriptor 

Set the buffer to global focus, control volume and get current position2. 
Attempted to create the buffer. 
If failed 

If Error was DSERRJNVAL1DPARAM 
Presume DirectX2 was found. 
Retry setting the parameters widi get current position2 
Call CreateBurTer 
If error 

Set variable structure size to magic number 20 (for 

NT4) 

Call Create Buffer 
If error 

Set to GetPos 2 
Call Create Buffer 
If error return fault 

End if 

End if 
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Else if 




Return 1 




End if 




End if 




Set Volume of buffer 




If failed set no volume control to true. 




Return ok 



Method: 


int Play( BOOL bLooped) { 


Input: 


BOOL 


Ouput; 


Int 


Description: 


Play the DirectSound buffer 


Pseudocode; 


Check for prior error. If so exit 

Check for the e>dstence of a buffer Create if necessary. 

Restore the buffers if they are Lost 
Fill the entire buffer with wave data 

Always play widi the LOOPING flag since the streaming buffer 

If error return 
wraps around before the entire WAV is played 
Start the thread processing. 
Set paused to false. 
Return ok 




Method: 


int AudioRenderer::FillBuffer( BOOL bLooped ) { 


Input; 


BOOL 


Output: 


int 


Description: 


Fills the DirectSound buffer with wave data 


Pseudocode; 


If prior error return. 
If no buffer return. 

Set buffer data flow measuring variables 
Set buffer position to start of buffer. 
Write Data into the buffer 
Return ok 




Method: 


int ReSeekO 


Input; 


SeekTime 


Output; 


Int 


Description: 


Empties audio Codec buffers and restarts at new time 


Pseudocode: 


If ErrorCode and it is not a DirectX stopped playing fault return error 
Wait 1 second to collect tile mutex for the direct 
switch dwWaitResuit 

Case Successful collection of the mutex. 

If not paused, pasue, then if error return error. 

Empty the buffers from the audiocodec. 

Calculate the seek location. Store in 
g_d wProg ressOffset 

Call RHBuffer, if error return error. 

Reset DirectX stopped playing variables, and continue, 
CASE MutexUnavallable 
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Set Error 




return error 




end switch 




Release Mutex. If error, set error und return error 




Return ok 



Method: 


Int WriteToBuffer( BOOL bLooped, DWORD 
dwBufferLength) 


Input; 


BOOL, DWORD 


Output: 


int 


Description: 


Writes wave data to the streaming DirectSound buffer 


Pseudocode; 


Lock the buffer down, at the last written position. 

If IgjDFoundEnd 

Stuff the buffer regardless if paused or not 
Grab data and copy to the streaming buffer 

else 

Fill the DirectSound buffer with silence 

If the end of the wavefile has been located, just 

stuff thebuffer with zeros 

If the number of bytes written is less than the 

amount we requested, we have a short file 

end if 

Now unlock the buffer 




Method: 


int Stop() 


Input: 


None 


Output: 


int 


Description: 


Stop the DirectSound buffer 


Pseudocode: 


If buffer exists 

Stop the buffer 

If error, set error and return error 
Set pasued 

End if 




Method: 


DWORD WINAPI AudioCallback< LPVOID TAudioRenderer) 


Input: 


LPVOID 


Output: 


DWORD 


Description: 


Handle the notification that tell us to put more wav data in the 
circular buffer 


Pseudocode: 


If thread is requested to continue 

Wait for the sound buffer to be available to talk to (infinitely). 
Locate the current buffer position. 

Check for buffer wrap around for empty buffer space calculation. 
If there enough space to write data into buffer. 

Write To Data Buffer 

If error record error and exit thread. 

Update progress. 

Release Mutex 

If Error return error and exit thread 
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Sleep 5 milliseconds. 




Else If 




Release Mutex 




If Error return error and exit thread 




Sleep (Notify time) 




End if 




End if 




Exit Thread cleanly 



Method: 


int AudioRenderer::RestoreBuffer$( BOOL bLooped ) 


Input: 


BOOL 


Output: 


int 


Description: 


Restore lost buffers and fill them up with sound if possible 


Pseudocode: 


Check if direct sound object exists. If not return. 

Get the status of the buffer - This checks if the buffer is available for 

usage. 

If fault record error and return error. 
If buffer is lost 

Attempt to restore ad Lnfiniteum, if the buffer is still lost. 

Pill the buffer 

End if 
Return ok 




Method: 


int PauseO 


Input: 


None 


Output: 


Int Status 


Description; 


Pause the Direct Sound Buffer 


Pseudocode: 


If buffer doesn't exit return ok 
If Mutex doesn't exist return ok 
If is already paused, return ok 
Set paused to true. 

Wait 1 second to collect the mutex for the direct sound Interface, 
switch depending on dwWaitResult 

CASE: Successful collection of the mutex. 
Call Stop Buffer 

If Error record error and return error 
CASE:Cannot get mutex object ownership due to time-out 
Record Error and Return Error, 

End switch 
Release Mutex. 

If Error record error and return error 
Return ok 




Method: 


int ResumeO 


Input: 


None 


Output: 


Int Status 


Description; 


Resume the Direct Sound Buffer 


Pseudocode: 


If buffer doesn't exit return ok 
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If Mutex doesn't exist return ok 




If is already paused, return ok 




Set paused to false. 




Wait 1 second to collect the mutex for the direct sound interface. 




switch depending on dwWaitResult 




CASE: Successful collection of the mutex. 




Call Play Buffer 




If Error record error and return error 




CASECannot get mutex object ownership due to time-out 




Record Error and Return Error. 




End switch 




Release Mutex. 




If Error record error and return error 




Return ok 



Method: 


BOOLAtEnd(voicl) 


Input; 


void 


Output: 


BOOL 


Description: 


Return the status of the AudioRenderer (Has it run out of data) 

This is to ovecome global optimisations, That allocate the g_bFound£nd to be 

local. 


Pseudocode: 


returns bFoundEnd 




Method; 


Int ThreadHealthyO 


Tnput; 


None 


Output: 


Int 


Description: 


Works out if thread is dead 


Pseudocode: 


ff error is DirectX stopped playing return StoppedPlaying 
if Thread is Dead 
return yes 

end if 
return no 




Method: 


DWORD PlayedTlmeO 


Input: 


None 


Output: 


DWORD 


Description: 


Return number of milliseconds played, and checks if DirectX 
is playing when requested to. 


Pseudocode: 


If tested is negative, then set to initial value of get tick count 

Get Current Buffer position. 

if Error, Set Error and return Error, 

Calculate the milliseconds. 

Milliseconds = ((g_jjwProgress- dwPlayPos))/g jjwBufferSize) 

# g_dwBufferSize+g_dwProgressOffset+dwPlayPos)/ 

g^AudioTimeDivsor) 
if not paused and Milliseconds is less than Last Played 

if greater than half a second behind, set fault to playback not 

running, 
else if 



♦ I 



WO 03/005190 


PCT/AU02/00922 

-33- 




Update timing variables 




end if 




end if 




if Milliseconds = 0 Mil1i$econds++ (divide by zero feu Its) 




return Milliseconds 



Method: 


BOOL CALLBACK DSoundEnumCallback( GUID* pGUID, 
LPSTR strDesc, LPSTR strDrvName, VOID* pContext ) 


Input! 


None 


Output: 


BOOL 


Description; 


Enumerates all available Direct Sound devices for playback. 


Pseudocode: 


Record GUID details and return 



5 
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CLASS NAME: 
Codec 

ATTRIBUTES: 

Width of the decompressed frame 

unsigned int stride 

For the DIVX codec 
DEC_SET dec_set 
DEC_PARAM dec_param 
DEC_FRAME decjfram 
DECJV1EMREQS dec_mem 
Type of decompression rendering from the codec 
VideoDecodeFormatType videoIWode 

Is ok flag 

DWORD divx 



METHODS: 



Method: 


Codec(BITMAPINFOHEADER *bili, VideoDecodeFormatType 
BitsPerPixelMode) 


Input: 


BITMAPINFOHEADER *bih, int BitsPerPixel 


Output: 


None 


Description: 


Codec constructor. Initialises all member attributes of Codec 
Class 


Pseudocode! 


Set ErrorCode to none 
Set divx to false 

Sri videoMode « NOT DEFINED 
Set Memory Buffers to NULL 
if t>ih exists 

if bih has a biCompression attribute that is equivalent to 4 

bih->biCompression equals mmioFOURCCCD', T, 'V, 'X*) 

end if 

if bih->biCompression equals nimbl-OUR-CCCD', T, 'V, X) 
set dec_param.x_dira equals to bih->biWidth 
set decj3aram,y_dim equals to bih^>biHeight 
set dec^ram.oinput^format equal BitsPerPixelMode 
set videoMode to same 
Set decjparam,tnne_rncr equal to 1 5 
call the decore and request the size of required memory 

structures. 
Set stride = width of bitmap* 

Allocate memory according to size requested by Decore. 

If memory doesn't allocate exit 

Clear all the memory allocated. 

Call and Inhialise the decore. 

Set the post processing filter level to 100. 

Call the decore and set this parameter 

Set DivX to one. 

End if 
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| | End if 


Method: 


-CodecO 


Input: 


None 


Output: 


None 


Description: 


Deletes and frees up all memory used by the Codec Class 


Pseudocode: 


Call Close 




Method: 


IntlsOKO 


Input; 


Int 


Output: 


None 


Description: 


Checks whether the codec was successful 


Pseudocode* 


if divx is not equal to 0 

Return true 
End if 




Method: 


int GetVideoMode() 


Input: 


None 


Output: 


Int 


Description: 


Gets the video mode 


Pseudocode; 


return videoMode 




Method: 


char *GetCodecNameO 


Input: 


None 


Output: 


char * 


Description: 


Returns codec name 


Pseudocode: 


If itsdivx 

return "Egenie OpenDivX video codec" 

end if 

return NULL 




Method: 


int Close() 


Input: 


None 


Output: 


Int ok 


Description; 


Deletes all the memory allocated to the codec* 


Pseudocode: 


If its divx «■ 1 

Call the decore and tell it to release. 
Deallocate all memory allocated for the codec. 




Method; 


int Decompress(char *in, long in size, char *out) 


Input: 


char *in, long in size, char *out 


Output: 


Int 


Description: 


Decompress frame 
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Pseudocode; 


If its divx =» 1 

dec_frame .length equals in_sizc 
dec_fTBme.bit$tn*am equals in 
dec_frame.bmp equals out 
dec_frarnc.stridc equals stride 
dec_firame.render_flag equals 1 

decore(according to decj>aram just setup) 

end if 
return 0 




Method: 


int Drop(char *in, long in size, char *out) 


Input: 


char *in, long in size, char *out 


Output: 


tat 


Description; 


Drop frames 


Pseudocode: 


If its divx =1 

decjrame.length equals Injize 
decjrame.bitstream equals in 
decjrame.bmp equals out 
decjrame,stride equals stride 
dec^framcrende^flag equals 0 
decore(according to decjparam just setup) 

end if 
return i 




Method: 


void HandleErrorO 


Input: 


WindowTitle 


Output: 


int 


Description; 


Reports and error to the user (safely) 


Pseudocode; 


Call Close 

Print The Error String 
Report Error to the user. 




Method: 


int SetPostProcessorLevel (int Percentage) 


Input: 


Percentage 


Output; 


int 


Description; 


Sets the amount of post processing filtering 


Pseudocode: 


Set dec_set.postproc_leveI to input Percentage 
Call the decore with the new settings 
Return ok 
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CLASS NAME: 
VideoBuffer 

DESCRIPTION: 

5 Creates a buffer, which stores decompressed frames. 

ATTRIBUTES; 

Pointer to the decaps structure that returns the file stream, 
decaps 

Pointer to the decoding class that decompresses the file stream, 
codec 

Temporary frame buffer storage array. 
framcs[BIJFFER_SIZE] 
A temporary buffer storage for the input stream. 
input_bufter 

Number of free frames left in the videobuffer 
frcejlots 

Size of the frame in the frame buffer 
framc_sizc 

The status of the frames in the buffer. 
frame_buffer_j5tatus 
The time taken to buffer 5 frames 
TotalTimeForSFrarnes 
Error Checking / Reporting. 
ErrorCocte 
ErrorMessage 



METHODS: 



30 



Method: 


VideoBufier(AviDecaps *decaps, Codec *codec) 


Input: 


AviDecaps *decaps 5 Codec *codec 


Output: 


"None 


Description: 


VideoBuffer Class constructor 


Pseudocode: 


Set input_buffer to NULL 

Set decaps to decaps. 

Set codec to codec. 

Set freeslots to number available. 

Clear the error settings. 




Method: 


-VideoBufferO 


Input- 


None I 


Output: 


None 


Description: 


VideoBuffer destructor class, frees all memory used by 
VideoBuffer 


Pseudocode: 


Call Stop 



15 



20 
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Metbod: 


Initialise(int BitsPerPixelMode) 


input: 


Bits per pixel Mode 


Output: 


int 


Description: 


Sets up the frame buffers, . 


Pseudocode: 


If no codec or no decaps return error 
Allocate memory for the input ^buffer 
if fail, return 

Clear input_buffer memory. 

Allocate memory for the frame_buffer_staius 

If fail, return 

Clear frame J>ufTer_status memory. 

Calculate frame memory size from width height and bits per pixel. 
Loop while frames to be created exist 

Allocate memory for the frame_puffer 

If fail, return 

Clear framej^uffcr memory. 
Set tag to empty frame 

End loop 
Return ok 




Method: 


int StartO 


Input: 


None 


Output: 


None 


Description; 


Starts the process frame storing process. 


Pseudocode; 


Store start time for processing 

Fill all the frame buffers, by calling GiveMeAFrame. 

Stop timing and record time taken to process a frame. 

Set free slots to frill 

Return ok 




Method: 


void StopO 


Input: 


None 


Output: 


None 


Description: 


Deallocates the input buffers and frame buffers 


Pseudocode: 


Safely destroy the input buffer 
Safely destroy all the frame buffers. 




Method: 


Char *GiveMeAFranieO 


Input: 


Frame and Buffer Number. 


Output: 


Int 


Description; 


Returns a decompressed frame 


Pseudocode: 


Check if a buffer is available. 
If so 

Set it status to played. 
Set Frame to the Frame 
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Rerun ok 




End if 




Call the decaps to get data for next video frame. 




If last frame, set frame to nothing and return ok 




If decaps error, set error and frame to nothing, return error. 




Call the codec to decompress the frame. 




If error, set error* and return error 




Set Frame equal to the decoded frame 




Return ok 



Method: 


int DropO 


Input: 


None 


Output: 


Int Status 


Description: 


Drops Frame 


Pseudocode: 


Call the decaps to get data for next video frame, 

If last frame, set frame to nothing and return ok 

If decaps error, set error and frame to nothing, return error. 

Call the codec to drop the frame. 

If error, set error, and return error 

Return ok 




Method: 


void HandleError 0 


Input: 


WindowTitle 


Output: 


void 


Description: 


Displays a message to the user on error 


Pseudocode: 


Call Stop. 

If error was a decpas error, refer to decaps error handler and return 
If error was a codec error, refer to codec error handler and return 
Print The Error String 
Report Error to the user 
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CLASS NAME: 
VideoRenderer 

DESCRIPTION: 

VideoRenderer handles all the video drawing capabilities of the egenie player. 

ATTRIBUTES: 

Linked List of Video Modes. First item pointer 

FirstEnumeratedMode 

Current pointer for callback function use, 

CurrcntEnumeratedMode 

DirectDraw object 

DirectDraw primary surface 
g_pDDSDisp!ayl 
DirectDraw secondary surface 
g_pDDSDisplay2 

DirectDraw overlay surface (front buffer) 
g pDDSQverlayl 

DirectDraw overlay surface (back buffer) 

gjpDDSOvcrIay2 

DirectDraw frame surface 

gjpDDSFrame 

DirectDraw Clipper Object 

gJpCHpper 

Was a user specified size put into the player? 

DefaultDisplay 

Bit depth of decore surface. 

DecoreBitsPerPixel 

Bit depth of screen surface. 

SerccnBitsPerPixel 

decoding format that the decore will use. 

VideoDecodeFormat 

Pixel Code for Decore. 

FourCCPixelFormat 

Storage of Window Identifier 

hWnd 

Size of fullscreen display 

\V_scrcen_size_x 

W_sereen_jsize_y 

The memory size of edge of the screen in bytes that doesn't get drawn to 

W_Xoflset 

W_Yofrset 

X stretching information 
WXFrameSca leData 
W_YFrameScaleData 

This is the Fuil_Screen version of the display parameters 

FS_$creen_size_x 

FS scrcen sizc_y 

FS_XoffceT 

FS_Yoffcet 

FS_XFraiueScaleData 



WO 03/005190 



PCT/AU02/00922 



-41 - 



FS_YFrameScaIcData 

This variable remembers if the video renderer was previously initialised 
MediaChanging 

Tliese variables are used on a warm. 

OlcL_FS_SSX 

01d_FS SSY 

Old W SSX 

Old^YVSSY 

OldUsingOverlays 

OId_SoftwarcStretcIiing 

More accelerated video variables 

g^bSoftwa reStretch i ng 

SurfaceFmmeCriteria 

ForceSourceColourKeyOfT 

Total video memory available for using 

AvattabieVidcoMemory 

PrimaryDisplayVideoMemory 

This is a memory of the supported rendering modes . 

AvailableRenderModes 

Reader tags 

JNoOvcrlayFIipping 

UsingOverlays 

total time taken to lock a frame 

AverageLockTime 

Counter for back buffer erasing (manually) 
FirstFrames 

Saves the window size & pos. 
g_rc Window 
g_rc Viewport 
g_rcScreen 

ls"the app in windowed or full screen mode. 
g_bWindowed 

App can't switch between fall screen and window mode 

g_J?SwitchWindowFS 

Error Handling 

ErrorCodc 

ErrorMessage 

Bitmap information from Decaps class 
bib 



METHODS: 



Method: 


VideoRendcrerQ 


Input: 


None 


Output; 


None 


Description: 


Constructor foT VideoRenderer class 


Pseudocode: 


Initialise Media_Changing 




Initialise gj>DD 




Initialise ErrorMessage 




Initialise FirstEnumeraledMode 




Initialise ErrorCodc 




Initialise g_b Windowed 
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Initialise g pDDSDisplayl 




Initialise g_pDDSDispiay2 




Initialise Old_FS_SSX 




Initialise OId_FS_SSY 




Initialise Old_W_SSX 




Initialise Otd_W_SSY 




Initialise OldJUsingOverlays 




Initialise FirstFrames 




Initialise Old SoftwareStretching 



Method: 


Constructor(int ScreeaSize_x s int ScreenSize_y,int 
FullScreen3ITMAPINFOHEAI)ER * ThisBitMap) 


Input: 


See above 


Output: 


None 


Description: 


Constructor for VideoRenderer class after DirectX init 


Pseudocode; 


Initialise g pDDSOverlayl 
Initialise &_pDDSOverlay2 
Initialise g_pDDSFrame 
Initialise g_pCiipper 

Initialise ForceSourceColourKeyOfF 
initialise ForceDestmationColourKeyOfF 
Initialise W_XFrameSca!eData 
Initialise WJVTrameScaleData 
Initialise FS JCFrameScaleData 
Initialise FS_YFrameSca!cData 
Initialise VidcoDecodeFormat 
Initialise UsingOveriays 
Initialise DefaultDisplay 
Initialise FirstFrames 
Initialise SurfaceFranieCriteria 
Initialise ScreenBitsPerPixel 
Initialise DecoreBitsPerPixel 
Initialise g_bSwitchWindowFS 
Initialise bih 

If no screensi ze was specified, then 

If data 1=1024 use the bill sizes for both window and full screen. 
Else set a suze of 512x384 and this is for "no clip" mode. 

Else if 

Set the screen size to requested size. 

End if 

Set to window mode is not fullscreen and not MediaChanging. 




Method: 


-VideoRendererQ 


Input: 


None 


Output: 


None 


Description: 


The default destructor 


Pseudocode: 


Delete variables by calling safe exit 



5 
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1 Method: 


void SafeExit(Destruct) 


Input: 


Variable to determine if interface should be destroyed 


Output: 


None 


Description; 


This function safely deletes all the dynamically allocated variables* 


Pseudocode; 


Destroy the Display structures, if they exist 
Destroys the handle to the Direct Draw object 
If Destruction of interface is required 

Free chain of linked list modes. 
Safely delete W_XframeScaleData, W_YframeScaleData, 

FS XframeScaleDataandFS YFrameScaleData 




Method: 


void HandleError(char * WindowTitle) { 


Input: 


char* 


Ouput; 


None 


Description; 


The error handler for the windows functions. 
Display a message to the user and return. 


Pseudocode: 


Call safccxitQ 

Tell the user about the fault 




Method: 


void Close(void){ 


Input: 


Char * 


Ouput: 


None 


Description: 


The error handler for the windows functions. 
Display a message to the user and return. 


Pseudocode: 


Call safeexit(don T t destroy interface) 
Set MediaChanging to True 

Record current windows sizes (window and Fullscreen) 
Remember rendering mode. (Overlay and software) 
return 




Method: 


int ReleaseAUSurfacesO 


Input: 


None 


Output: 


Int 


Description: 


Release all surfaces used. 

Also when switching from windowed to full screen, all surfaces 
must be released. 


Pseudocode: 


Destroy the Display structures, if they exist, Primary Display, Overlays, frame. 




Method: 


Int CheckAvailableDisplayMode(int * SSX,int * SSY,int * 
BPPOnt * RR) 


Input: 


int *, int*, int *,int * 


Output: 


Int 


Description: 


Checks if a display mode is available with the passed in criteria 
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Returns number if ok, -1 if error. 


Pseudocode: 


Start at start of linked list. 

Pass tlirough linkedlist, comparing parameters of each mode to the requested 
one. 

If an acceptable mode is located, return the number. 
Else return -I 




Method: 


BOOL VideoRenderer::RestoreAll(void) 


Input; 


None 


Output: 


None 


Description; 


Restore all lost objects 


Pseudocode: 


Call restore on each object if that object exists. 

Collectively grab the return result, and if all come back with OK then the return 
result is ok. 
Return result 




Method: 


int VideoRenderer::OpdateFrame(HWND hWnd) { 


Input; 


HWND 


Output; 


int 


Description; 


Take the bitmap data and send it to the videocard* 


Pseudocode: 


Create a directX surface description structure and initialise. 
If a pre-existing error is present return error 
If Rendering is software mode 

Lock the secondard Display for -writing. 
If error, store error and return error. 
Calculate and store Xpitch. 
If the FiratFramcs is less than three. 

Calculate the Y_Oflset for displaying to the screen 
Increment Firstf rames 
Blank the entire memory area, 

End if 

Depending on 16,24 or 32 bit screen mode, run different 

assembly language stretching code. 
Setup initial variables for assembly language to pass from code. 

Source data pointer 

Destination data pointer 

Width of Frame 

Byte$ per scan line 

X Scaling Data 

Y Scaling Data 
Assembly Code 

Loop each Vertical scan line 

:;Y_AilLoop 

Grab Y repeat rows. 

:: Y_Loop 

Increment Y source line only if finished. 

:: X Loop 

Read pixel of data 

Read number of time to be repeated. 

Write that number of times. 
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Increment X 




cna or kovv.' no Jump to a Loop 




Enough Y line repeated? No Jump to Y^Loop, 




Elld 01 KOWSr IN0 JUmp 10 LOOp 




Asseniebly Code End 




Unlock Display2 Surface. 




If Error save error and return Error 




While loop 




If windowed Attempt to Bit Display2 to Display l 




Else attempt to flip the displays. 




If successful, return ok 




If more than 200 attempts, give up, return error. 




If surface lost, restore surfaces and continue 




If surface busy, sleep and continue while loop 




If other error, record error and return error 




End While 




Else If 




If not usingoverlays then 




Lock the frame surface 




If error record error and return error 




Memcopy the bitmap data to the frame memory 




Unlock the frame surface 




If error record error and return error 




Get the desktop coordinates and calculate the screen 




location for the data. Allow for letterbox ing and 




non 4x3 aspect ratio. 




If FirstFramcs is less than 3, blank Display2 1 prior to 




flipping, increment firstframes 




Bit Display2 to Display 1 




If error record error and return error 




While loop 




it wuiuowea Attempt to uit Displays to L?ispiayi 




Else attempt to flip the displays. 




If successful, return ok 




ii more man zuu attempts, give up, reruni erroi. 




If surface lost, restore surfaces and continue 




If surface busy, sleep and continue while loop 




If other error, record error and return error 




oiu vywn? 




DISC IT 




Lock the overlay surface 




If error record error and return error 




Memcopy the bitmap data to the overlay memory 




Unlock the overlay surface 




If error record error and return error 




If FirstFrames is less than 3, blank Display 1, prior to 




displaying the overlay on the surface, increment 




first frames 




If overlay flipping required 




While loop 




attempt to Hip the overlays. 




If successful, return ok 




If more than 200 attempts, give up, 




return error. 
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If surface lost, restore surfaces and 




continue 




If surface busy, sleep and continue 




while loop 




If other error, record error and return 




error 




End While 




£Ise if 




Call DisplayOverlay to perform update. 




End if 




End if 




End If 




Return ok 



Method: 


HRESULT WINAPI EnumAllModesCallback( 
LPDDSURPACEDESC pddsd, LP VOID pVideoR) 


; Input: 


LPDDSURFACEDES, LPVODD 


Output: 


HRESULT WINAPI 


Description: 


For each mode enumerated, it adds it to the "All Modes" listbox. 


Pseudocode: 


Allocate memory for the display mode 

Copy the memory structure to the enumerated link list 

Check if first mode to be added to the linked list 

If first mode, then set up the pointers 

If not first mode, create and parse the linked list 




Method: 


int VideoRendercr: :MtSurfaces(WmdowSettingsMode 
WindovvMemory) 


Input: 


int 


Output: 


int 


Description: 


Create alJ the needed DDraw surfaces and set the cooperative level 
with the operating system. 


Pseudocode: 


If windowed mode then 

If not MediaChanging 

Set FirstFrames to zero 

Set normal cooperative level with Direct X 

If Error save error and return Error 

End if 

Set DestroyPrimaryDisplay to false 
If Media changing then 

If dimensions or resolution or render mode of primary display 
If DestroyPrimaryDisplay is true then 
Safely Release Displayl 
Safely Release Display2 
SetWindowPosition back to orignal window. 
Reset FirstFrames 

End If 

End if 

Grab location of window relative to desktop. 
If Displayl does not exist 
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Depending on render flags, create Display 1 




If Error save error and return Error 




End ii 




Create Clipper 




If Error save error and return Error 




Set Clipper lo Window 




If Error save error and return Error 




Set Clipper to displayl 




If Error save error and return Error 




If not using overlays then 




Create Display2 




If Error save error and return Error 




End if 




If not using overlays and not software rendering. 




Create frame surface 




If Error save error and return Error 




Else if 




Set Frame surface equal to nothing. 




End If 




Else if 




If should remember window settings 




If not media changing 




Grab location of window relative to desktop. 




Else if 




Create location for window on desktop. 




End if 




End if 




If Media changing then 




If dimensions or resolution or render mode of primary display 




If DesUroyPrimaryDisplay is true then ' 




Safely Release Displayl 




Safely Release Display2 




Reset FirstFrames 




End If 




End if 




If Displayl does not exist 




Depending on render flags, create Display 1 




If Error save error and return Error 




If not using overlays 




v^rcatc jjispiay z 




I f Error save error and return Error j 




Else if 




Set Display 2 to notiiing. 




End if 




End if 




If not using overlays and not software rendering. 




Create frame surface 




If Error save error and return Error 




Call PerformBlittingPcrformanccTest 




If fail return error 




Else if 




Set Frame surface equal to nothing. 




End if 




End if 
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IfUsingOverlays 




Create overlay surface 




If Error save error and return Error 




If flipping surface exists, grab it. 




If Error save error and return Error 




End If 



LYletQOU. 


int ViHf»nftpnHr»rf i r»«TnifViHAnf r T^WNTT) ^nhWrtfi 

LIlv V LU-CUlVCUtlCVCl „.lilK V lLLCU^ ITL YV INJJ pil VY liu.j 




lesfcngDisplayModes) { 


Tnput: 


HWND *, bool TestingDisplayModes 


Output: 


Int 


Description* 


T\rt wrfstlr ■fAniiif^H "Frit* waw inctani^A thf* flfYttlif^flf inn CVf^site tnfi 




window, initialise data 


Pseudocode: 


If not media changing 




Create Interface to DirectX 




If Error save error and return Error 




Enumerate and store ail supported modes along with supported bit 




If Error save error and return Error 




Call gctAccurateVideoMemory 




If Error save error and return Error 




End if 




G etCurrentDisplay Mode 




If Error save error and return Error 




If not media changing 




Call GetSupportedRenderMode 




If Error save error and return Error 




End if 




Set original criteria for display selection 




If DeraultDIspIay set requested size to current screen size. 




11 (putting Kenuer iviooe Avauaoie^ 




If desktop is 1Gbit and overlay mode is available goto OveriayMode 




If desktop is 16,24 or 32 bit then 




Set DecoreBPP to DesktopBPP 




if enough video memory is available for some blitting 




if AvailableDisplayMode 




if Enough video memory available for full blitting 




Set ScreenBPP equal DecoreBPP 




Goto Blitting 




End if 




while DetaultDisplay and greater than 640 wide 




if GctNetftSmaJlcstDisplaySize fails 




Reset Variables 




Goto OverlayingMode 




end if 




if available video Memory then 




Set ScreenBPP « DecoreBPP 




Goto Blitting ■ 




end if 




End while 




Reset variables 




Goto OverlayingMode 




End if 
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if* not win H nw mnHp 




5ei error ana reiuTTi error 




el$e if 




Spf 5\rrr ptiRPP pmial nRrortiBPP 




Owi no run acrccii ^vn liLiungj. 




VJOIO DHLlUlg 




end it 




end if 




jena li 




end 11 




ljolo uveriayingivioGe 




Bliitiig: 




If not TestingDisplayModes is true 




Call Initsurfaces 




If error then reset variables and goto OverlayingMode 




Jin a it 




Goto RenderModeSelected 




OverlayingMode: 




it Overlay KenderMode Available then 




Test if any overlay Modes have stretching capabilities. 




ir not tnen goto aoitwarcivioac 




unccK ir iifst locaiea overlay nas nipping surraces avaiiaDie 




If not, set no flipping flag. 




If CheckAvailableVideoMemory returns ok then 




OverlayFullSoreenTest: 




screenisrr - videoMoaeiirr 




ji Ilo LMspiayrviocie is Avanaoie tnen 




If CheckVideoMemory Available returns ok 




Set usingOverlays to One 




Goto Overlaying 




Una it 




u Screen rSJrr > 10 men 




.TYlLwlLIjJl ICUUUlllg OviCCllDl r LU IV 




11 IVldllUlj S_/llWVI\. Id \JiS. 




oei usingwvenay^ to wnc 




f'irvt'rt | n \\fiai , l lAriTirt 

uuio wvcrmying 




Else If 




1\ Cat Oic Dfr. 




Fnd if 




End if 




while DefaultDisplay and X_size > 640 




If Can't find small display Mode then 




Reset Sizes 




Break 




End if 




if Check Available Video Mode is ok 




Set usingOverlays to One 




Goto Overlaying 




End if 




End while 




Set No overlay flipping to true 




if Check Available Video Mode is ok 




Set usingOverlays to One 




Goto Overlaying 
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End if 
















1L Yv 1X1UU Vr IY1UUC loll I aClCU LCU 




Tf r^pfniiltT^icnlsw ic tnip 

11 J-'CLilUlLL/liJJlvljr la UUC 




YJpivirt" Tv/lpccaorp tn T Tqpp Flirppt T£ ic Tint nmnpflv 
xvcpuLi irxcaaaj^v lvj u»ci l/ucwi a la iiuv piv/j/w iy 




Tncttl IaH 




A\.VJWL V «1 ICWlVJ 




rerrant r b switcning 




uoto oOuwaieivioae 




cllO 11 




Cat T7rT>r\T> vd'HiTTi ott/ip 

set error, return err or 




else it 




dei U5ingv/venayj> to Que 




Kemove switcning 




mOlo vjvendymg 




bnali 




Endif 




bet Noiiippitigr lag ioi rue 




If CheckAvailableVideoMemory returns no then 




Reset Flipping Overlay Selected 




li w lnaowMoaeKequirea 




wL i dfclIIlCLCrij 




uoto ooitwareMoae 




EdlQ 11 




uisaoie ruuocreen switcning 




r nf i :f 




VjyiU v»Ll ltiyriUliaUlwL.il J G3l 




CUQIT 








11 IIUL I CbLlLlgi>l3pidyivlUUCj la ULIC 




f 'oil Trt Itciit*fia/*po 
v^dll JJlllSllOdCCa 




ii error men rebel vdriaDiea «nu gOiu ooiiwareiviuuc 




End if 




OOiO JtXviLUeriYiOUvoClCwCU 




oo ii w ctreiyio ue • 




<Jpf T?pnnp«?fpH Hi^nlav MnHi> (64.0x4X0") 




Set DecoreBPP to ScreenBPP 




If DecoreBPP is less than 16 then 




Store error and return error 




End if 




Set ScreenBPP to DecoreBpp 




Set SoftwreMode to true 




[f not TestingDisplayMLodes then 




Call Initsurfaces 




If error then reset variables and return 




Endif 




If not Tetf tngDisplayModes then 




Determine from aspect ratio of screen and video, blank 




areas around the screen. Store in Offset Variables. 




Create scaling data for Full Screen and window mode for 




Software stretching of the image. Store in Scale data 




Variables. 



WO 03/005190 




PCT/AU02/00922 


-51- 






End if 






Set MediaChanging to false 






Return ok 





5 



Method: 


int ScreenSizeX(void) 


Input: 


None 


Output: 


Int 


Description: 


Return the screen size X 


Pseudocode; 


return FS screen stee x or windowed depending on Windowed Mode 




Method: 


int ScreenS izeY(void) 


Tnput: 


None 


Output: 


Int 


Description: 


Return the screen size X 


Pseudocode: 


return FS screen size y or windowed depending on Windowed Mode 




Method: 


int BitsPerPixelMode (void) 


Input: 


None 


Output: 


VideoDecodeFormatType 


Description: 


Return the Bits per pixel mode 


Pseudocode: 


If Using Overlays 

Return VideoDecodeFormat 

Else If 

Return Bits per pixel of screen- (RGB565,RGB24,RGB32) 

End IF 




Method: 


int BitsPerPixel (void) 


Input: 


None 


Output: 


Int 


Description: 


Return the bits per pixel used by the decore. 


Pseudocode: 


Return DecOreBitsPerPixel 




Method: 


int GetCapsSafe(VideoCap$ Pointer (x2)) 


input: 


VideoCaps Pointer (x2) 


Output: 


Int 


Description: 


Provided the Direct X function call GetCaps "Safely" 


Pseudocode: 


If Software mode pointer is not NULL then 

Allocate memory for VideoCaps Structure 
If error store error and return error 
Clear memory 

End if 

If Video mode pointer is not NULL then 

Allocate memory for VideoCaps Structure 
IF error store error and return error 
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Clear memory 




End if 




If Software mode pointer is not NULL then 




Get Video Caps function. 




If failed, resize structure 




Get Video Caps function. 




If failed, store error and return error 




End if 




If Video mode pointer is not NULL then 




Get Video Caps function. 




If failed, resize structure 




Get Video Caps function. 




If failed, store error and return error 




End if 




Return ok 



Method: 


int GetSupportcdRenderMode (void) 


Input: 


None 


Output: 


Int 


Description: 


Get the available render mode$ in the video card. 


Pseudocode: 


Call GetCapsSafe, if error return error. 

Set AvailableRenderModes to Software only. 

Check the caps structure for Video Memory Bitting and Bit stretching, 

if available, set Video Memory Biitting flag available. 
Check the caps structure for System Memory Bitting and Bit stretching, 

if available, set System Memory Biitting flag available. 
Check the caps structure for destination colour key 

if available, set Destination Colour Keying flag to available. 
Check the caps structure for overlay capabilites 
If available 

If sufficient overlay surfaces are available 

Create overlay surfaces (very small in size) and check 
If they can be created with the 6 different colour modes, 
record this fact Attempt to create Hipping overlays as 
well If available record this in available render mode. 

End if 

End if 




Method: 


int GetAccurateVideoMemory(void) 


Input; 


None ! 


Output: 


Int 


Description: 


Calculate the amount of video memory 


Pseudocode: 


Create surface description structure. 

Set Bits Per Pixel to current video display mode. 

Set size to 5 12x256. 

Create as many surfaces as possible, until no memory error message is 

received. 
Halve the surface size 

Create as many surfaces as possible, until no memory error message is 
received. 
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Halve the surface size 




Create as many surfaces as possible, until no memory error message is 




received. 




Determine the amount of memory allocated for the primary display. 




Sum all the surfaces memories together. 




Free all the surface memories. 



5 



Method: 


int CheckAvailabieVideoMemory (DWORD TypeOfSurface) 


Input; 


Type of surfaces required. 


Output; 


lot 


Description: 


Calculate the amount of video memory required for surfaces 


Pseudocode: 


Use existing setting in program to determine sizes and bits per pixel 
Depending on the input parameters, check if each particular surface is 
Required. Add memory to sum total if that surface was required. 
If RequiredMemory is less than AvailableMemory return 0 
Else return 1 




Method: 


int GetNextSmallestFSDisplayMode (int BPP) 


Tnput; 


IntBPP 


Output: 


Int 


Description: 


Find the next smallest display mode with the same BPP* 


Pseudocode: 


Parse the linked list of display modes searching for the next smallest display 
mode. Find the one that is closest to the existing display mode, but only the next 
step smaller. 




Method: 


int PerformBiittingSpeedTest (int BPP) 


Input: 


None 


Output: 


Int 


Description: 


Performance test full screen blitting. 


Pseudocode: 


Create full screen surfaces. 
Attempt to flip mem 5 times. 

(Must be done vvith cooperative level appropriately set) 
record the time it takes to write the data and flip the screens 
If any 

If longer then 100 milliseconds 
Fail the performance test and return 1 
Else return 0 




Method; 


int GetSliderBarCoords (RECT * Rectangle) 


Input; 


RECT * Rectangle 


Output; 


int 


Description: 


Return the coordinates of the slider bar in screen cords* 


Pseudocode: 


Using the predefined sizes, and querying windowsMetrix functions, populate a 
Rectangle with the dimensions of the slider bar, so it can be drawn 
appropriately, (Independent of Windows or full screen mode) 
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Method: 


int GetSlidcrCoords (RECT * Rectangle,fIoat ratio) 


Input: 


RECT * Rectangle, float ratio 


Output: 


RECT * Rectangle 


Description: 


Return the coordinates of the slider in Screen cords. 


Pseudocode: 


Using the predefined sizes, and querying windowsMetrix functions, populate a 
Rectangle with the dimensions of the siider on the slider bar, so it can be drawn 
appropriately. (Independent of Windows or full screen mode) 




Method: 


irit DispIayOverlay (int CleaiBackBuffer) 


Input; 


int ClearBackBuffer 


Output: 


Int 


Description: 


Display an overlay safely. 


Pseudocode: 


Create caps structure for video capabilities. 

Call GetCapsSafe. j 
If error Store Error and return Error 

Determine alignment of the overlay, according to info provided by the caps 
structure. 

Determine stretching factor of overlay, 
According to DecoreBitsPerPixel, set colour key for screen. 
Setup the source rectangle from the dimensions of the image. 
Touch the alignment according to the Video Card capabilities. 
If Windowed mode 

f^lonl fllA i*}/*»etinafif*iTi TT>r>l-iTi trio 
^aHUlalL tilt- GCMinalHpn. n^CLuJlgie. 

Offset from top of screen to user window. 
Apply stretching factor, and use size of image. 
Determine if the client window intersects the screen bounds, 
if so clip the rectangle so the overlay only appears on the screen 
That actually exists. 

Else if 

Else apply stretch scales, and use FS_offsets calculated in 
Video init function 

End if 

Touch the destination rectangle if the video capabilities indicate that it requires 

to be moved. 

IfClearBaekBuffer 

Create colour blitting strucLurc. 

Populate fill colour with black according to the video mode. 
Colour Bit safe to the First overlay surface. 
If the is overlay flipping then 

Colour blit safe to the second surface 

End If 

End If 

Set UnsupportedEiTorOnce to false 
While always 

Attempt to Update the overlay 

If ok delete allocated memory and return ok 

If over 200 attempts, quit and store error and return error 

If surface lost reported, then 
restore all surfaces 
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i f error return error 




End if 




11 llll&ULJL/vl Lull dllul 




If error has harroenpd before return error 

»* wiiyi nap iJ^2|^^/vii^M wvlvlv 1 v*Vtl 11 vllvl 




Plfc/" It* 
CISC IT 




^et nappeneo previously nag 




Remove destination colour keying 




continue 




Pnrl If 




End If 




If generic Error 




Attempt to remove Source colour keying and continue 




Attempt to remove Destination colour keying and 




continue 




Else error if previous has been attempted. 




EndTf 




If no colour key hardware error 




Attempt to remove Destination colour keying and 




continue 




Else error if previous has been attempted. 




End If 




' Default - store error and return error 




End While 



Method: 


int HideOverlay (void) 


Input: 


None 


Output; 


int 


Description: 


Remove the overlay from the viewing surface 


Pseudocode: 


If graphics device interface exists 
If overlays are in use 

If Overlay 1 exists 

Hide the overlay. 

If error store and return the error. 

End Tf 

End If 

End If 




Method: 


int LockSafe (Surface, surface description, ErrorCode) 


Input: 


As Above 


Output; 


int | 


Description; 


Safely attempt to lock the video surface for drawing. 


Pseudocode: 


While always 

Attempt to lock the surface. 

If attempts exceed 20, store error and return error 

If result is ok return ok 

If Surface lost, restore all surfaces and continue 
If surface busy, sleep 5 ms and continue 
If no Memory, store error and return error 
Default - store error and return error 
End While 
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Method: 


int ColourBltSafe (Surface, surface description, ErrorCode) 


Input: 


AS above 


Output: 


int 


Description: 


Attempt to colour blit safely to the hardware. 


Pseudocode: 


Set timer. 
While always 

Auenipi 10 colour out using iiaraware 

If attempt exceed 100, store error and return error. 

If error generic or unsupported 

Lock the working surface 

I f error, store and return 

Get the clipper 

If error, store and return 

Get the clip list 

If error, store and return 

Parse the clip list, erasing the rectangles as necessary. 
UnLock the working surface 
If error, store and return 

End If 

If surface lost, restore surfaces and continue. 
If surface busy, then wait 5ms and continue 
Default - store error and continue. 
End While 




Method: 


int ChangeCoopLevel (Window Handle, WhatToDo) 


Input: 


As Above 


Output: 


int 


! Description: 


Switches display adapter between full screen and windows mode. 


Pseudocode: 


Call release all surfaces 
rf error return error 
If not windowed 

Call restore Display Mode. 

If error store error and return error 

Set window position to something reasonable., or previous 

If error store error and return error 

Else If 

Set window position to full screen 
If error store error and return error 

End If 

Invert windowed flag 
If reinitialisation is required, 
Call InitSurfaces 

If error Store error and return error 

End if 
Return ok 



Method: j int Display VideoMormation Q 
Input: I WindowTkle 
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Output; 


int 


Description: 


Provide a dialog box to the user displaying video information. 


Pseudocode: 


Populate string for displaying in dialog box, with information obtained about the 
video hardware. 

Particularity VideoMode used to render, date and version stamp, decore mode 
compatible with video card, bits per pixel of screen 
Create the message box and display. 




Method: 


int DisplayTextOnVideo (Message, Displays electionBar) 


Input; 


As above 


Output: 


int 


Description: 


Display information bar on the video screen. 


Pseudocode: 


Use GDI to draw a bar on the screen 

If the drag and drop bar is required, draw that in as well. 

Use Slider Bar position functions and 

Slider position functions. To place the slider bar 
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CLASS NAME: 
InputMedia 

5 ATTRIBUTES: 

Status variables 

mode 
filename 
10 ReSeeklnputThread 

Operating system Interface variables 
file 

Decoupling buffer variables 

buffer 
15 RainBuffer 

RamBufferMutex 

FilelOHandle 

FilelOMutex 

BufferStartedMode 
20 Data Status variables 

file stee 

InitialFfU 

IOFilePointer 

ReqFilePointer 
25 EOFInputFile 

AVTJ>ataReadingMode 

AVT_fi!e_size 

lastReadPos 

Computer status variables 
30 InputMed ia Rea d Rate 
Error handling variables 
ErrorMessage 
ErrOrCode 

Thread handling variables 

35 ThreadDead 

WaitingThread 



METHODS: 



Method: 


InputMediaO _ 


Input: 


None 


Output: 


None 


Description: 


InputMedia constructor. Initialises all the variables used by the 
InputMedia class 


Pseudocode: 


thi 5 ->filc -NULL 
this->mode ~ -1 
ErrorMessage = NULL 
ErrorCode = 0 
FilelOMutex = NULL 
RamBufferMutex = NULL 
RamBufTer = "NULL 
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FiiciOHandle = NULL 




ThreadDead - 0 




WaitingThread = 0 




BuiTerStartedMode = false 




AVI DataReadingMode = false 




SrartOfAVIData=0. 




ReqFilePointer = 0 




IOFilePointer = 0 




EOFInputFile^ false 




ReSeeklnputThread = false 



Method: 


KilllnputThread 0 


Input: 


None 


Output- 


Integer 


Description: 


Kills the reading thread and tidies up.. 


Pseudocode: 


BufferStartedMode = false 
If (Thread exists) 

Set thread waiting to exit flag to one. 
Set counter to zero. 
While (counter < 10) 
Sleep(lOms) 
Increment counter 
If (counter = 10) then 

Terminate thread 
Return 

End if 
End while 

FilelOHandle = nothing 
End if 

return 




Method: 


~InputMedia() 


Tnput; 


None 


Output: 


None 


Description: 


TnputMedia destructor. Cleans up all memory allocated to 
InputMedia, 


Pseudocode! 


KMInputThreadO 

If file is open Close the file 

Tf FilelOMutex Exists Safely Destroy Mutex 

If RamBuffcrMutex Exists Safely Destroy Mutex 

If RamBuffer Exists Safely Destroy Buffer. 



5 



WO 03/005190 



PCT/AU02/00922 



-60- 





O Leu. LLJ LLL1UI\0 ull LWJLioL-L J 


Input: 


Offsets into file to commence buffering 


Output; 


Successful completion 


Description; 


Start Buffer - Starts reading the file from disk and pre-charges the 
buffer. 


Pseudocode: 


Rewind the rile. 

Calculate offset for buffering into the flic. 

Create the reading thread 

Set BuffcrstartedMode to true 

Set Initial fill to true 

Wait while thread fills the RAM Buffer. 

Calculate time required to fill the input buffer, store in InputMediaReadRate. 
Set InitialFiil to false 

Set up Buffered Offset, store in ReqFilePointer, 
Always return Zero 




Method: 


int OpenCchar * IpFilename, int mode, int type) 


Input: 


char *lpFilenamc, int mode, int type 


Output: 


Int 


Description: 


Opens file IpFilename depending on mode and type 


Pseudocode: 


If IpFilename exists then 
initialize file 

switch depending on type 

case INPUT JTYPE^FILE: 

switch depending on mode 

case INPUTOPEN_BINARY: 
open IpFilename 
break 

case INPUTJDPEN_ASC1I: 
open IpFilename 
break 
default: 

open IpFilename 
end switch 
if file does not exist 
return 0 

end if 

mode INPUTTYPE_FILE 
filename = IpFilename 
set Windows read buffer to 32k 
seek the end of the file 
get the size of the file 
seek from start of file 
Allocate memory for the RAM Buffer. 
Create RAMBUFFERMutex 
If Create failed return 0 
Create FileiOMutex 
if Create failed return 0 
return 1 
break 
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default: 

break 

end switch 

end if 

return 0 



Method: 


DWORD WINAPI FUeReadThreadO 


input: 


LPVOID TinputMedia 


Output: 


DWORD WINAPI 


Description: 


Reads the input file from disk into a RAM Buffer, 


Pseudocode: 


Store the pointer for the Input media class and type cast 

Create a 32k read buffer. 

If Create failed set WaitingThread to 1 

Seek to start of Data in file. 

While (! WaitingThread) 

Set Data Quantity to 32k 

Check if the data read from the buffer is greater than half way 
through the buffer and End Of File hasn't been reached 
and BufTerSttartedMode is true. 

Grab FileTOMitex wait for ever 

Read DataQuantity from fde into ReadBuffer 

Check if 32k was read if not 

If fetream reports EOF then 

Set EndOfFile Flag to True 
Else Error as file can't be read. 
End if 
Release FilelOMutex 
Grab RamBufferMutex wait for ever, 
Copy ReadBuffer to RAMBuffer 
Update Read Pointer 
Release RamBufTerMutex 
Tf not InitialFill Sleep for 20 milliseconds 

Else if 

Sleep 50 milliseconds 

End if 
End while 
Delete readBuffer 
Set WaitingThread to zero 
SetThreadDeadto t 
Exitthread 
Return 0 
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Method: 


int isOKO 


Input; 


None 


Output: 


Int 


Description; 


Returns true if file exists 


Pseudocode: 


return this->file if not equal to NULL 




Method: 


getFilenameO 


Input: 


None 


Output; 


char * 


Description: 


Returns file name 


Pseudocode: 


return this->filename 
return NULL 




Method: 


getSizeQ 


input: 


None 


Output; 


DWORD 


Description; 


Returns file size 


Pseudocode: 


Ifthis->£He = 1 

return this->file_size 

end if 
return 0 




Method: 


int Read(char *data, unsigned int size) 


Input: 


Ram Buffer for Data extraction, Size - amount of data. 


Output; 


Int 


Description: 


Read data of specified size 


Pseudocode: 


If The thread Has exited and Buffers UrtcdMode then assume fault and return 0 
Switch depending on mode 

cose INPUT_TYPE_F1LE: (currently only one) 

if the file Isn't open and the RamBuffer exists then return 
0 

if (ReSeeklnputThread) then 

if(KilUnputThreadO) returns a fault return 0 

Calculate position in file to seek to. 

StartBuffer(calcu1ated position) 

Reset file pointer 

Set ReSeeklnputThread to false 

end if 

if (DaiaRequested is contained in the RAM Buffer) then 
if the thread has died return false. 
Grab RarnBuferMutex wait indefinitely 
Copy the memory from the buffer 
Release the RamBufferMutex 
Update ReqFilePointer 
Return Size 

else if 
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Grab FilelOMutex Wait indefinitely 

Grab the current file petition. 

Seek to the requested read location 

Read data from file. 

Seek to Ihe old location in the file. 

Release FilelOMutex 

Return Number of Bytes writen 

end if 
break 

default: 
end switch 

return 0 



Method: 


int Seek(int size, unsigned int method) 


Input: 


Long Seek t eferencc starting ooint 


Output: 


Int 


Description; 


Seeks in the file depending on method 


Pseudocode: 


Switch depending on mode 

case 1NPUT_TYPE_FELE: 
if the file exists 

Check if EOF is set, if so unset it prior to seeking, 
switch depending on method 
case INPUT_SEEK^SBT: 
seek in file 
break 

case INPUT_SEEK_CUR: 
if size equals 0 

return current file position 

else 

Jump to new location 
Return 0 

end if 
break 

case mPUT_SEEK_END: 

Set file pointer to End- seek 

return 0 

break 

end switch 
. end if 
break 

defeult: 
end switch 
return 0 




Method: 


int CloseO 


input: 


None 


Output: 


Int 


Description: 


Closes all uneeded methods 


Pseudocode: 


If the file exists 
close file 
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end if 




If it exists, safely delete the RAMBuffer 




return 1 



5 



Method: 


intThreadHealthyO 


Input: 


None 


Output: 


Int 


Description; 


Reports if thread is healthy 


Pseudocode; 


return ThreadDead 




Method: 


int HandleErrorO 


Input! 


Char* WindowTitle 


Output: 


None 


Description: 


Writes an error description for the user to interpret. 


Pseudocode: 


Close the media file 

Write the Error Message / Error Code to a preformatted String. 

if the error code is not 4070 (CDROM eject), then Display Message in a dialog 

box, 

return 
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CLASS NAME; 
AviDecaps 

DESCRIPTION: 

AviDecaps sets up the file by reading in all information needed for playback 

ATTRIBUTES: 

details of the video frames 

bitmapinfoheader 

details of the video audio 

waYefonuatex 

MPwaveformatex 

Video characteristics variables 

width 

height 

t'ps 

Video Compressor details 

compressor 

video_strn 

video_frames 

video_tag 

v id co_jjos 

Audio Characteristic Variables 

ajmt 

a_chans 

aratc 

aj>its 

audio^strn 

audio_byte$ 

audio_chunks 

audio^tag 

audio jposc 

audto_posb 

AVI handling variables 

pos 
njdx 
max_idx 
idx 

video_index 
audtojadcx 
last^pos 
lastjen 

m ust_u$e_ind ex 
movi_start 

Input Media handling variables 

hlOMutex 

input 

Error handling variables 

ErrorCodc 

ErrorMessage 
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Track counting variables 
CurrentlyPlayingTrack 



Method: 


AviDecapsO 


Input: 


None 


Output: 


None 


Description: 


AviDecaps constructor. Initializes all the variables used by the 
class 


Pseudocode: 


video_pos =0 
audio_posc = 0 
audio^posb - 0 
id* = NULL 
videojndcx * MULL 
audio Jndcx - NULL 
input = NULL 

ErrorMessage = NULL 
ErrorCode = 0 
this->bIOMutex - NULL 
this->CurrentlyPIayin|?Track - 0 




Method; 


~AviDecapsO 


Input; 


None 


Output: 


None 


Description: 


AviDecaps destructor. Cleans up all memory allocated to 
AviDecaps 


Pseudocode: 


Close all ODen files and delete temporary data structures 




Method: 


intlsAVlO 


Input; 


None 


Output: 


Int 1 


Description: 


Returns true if its an avi 


Pseudocode: 


If input exists 

If a chunk of data was read incorrectly 
Error "Error Reading" 
return 0 

end if 

if the chunk of data Is not identified as been an AVI 
return 0 

end if 
return 1 

end if 
return 0 




Method: 


int SampleSizeO 


Input: 


None 
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Output; 


Int 


Description: 


Returns the sample size of the first audio stream 


Pseudocode: 


Work out sample size 
return size 




Method: 


int FillHeader(int getlndex) 


Input: 


Int 


Output: 


Int 


Description: 


Fill the Class with info from headers and reconstruct an index if 
wanted. 


Pseudocode: 


read through the AVI header file (according to AVI RFC) 
extract the header objects 
verify the AVI header objects. 

read start position of the 'movi' list and optional idx 1 tag 
interpret the index list 

generate the video index and audio index arrays. 




Method: 


int AddIndexEntry(char *tag, long flags, long pos, long len) 


Input: 


char *tag, long flags, long pos, long len 


Output! 


Int 


Description: 


Add an entry to the global index this function is used while 
reading. 


Pseudocode: 


If njdx is greater or equal to max_idx 
Reallocate memory tor idx 
max idx equals max idx plus 4096 
idx-(char((*)[l6]))ptr 

end if 

add the index entry 
Update counter 
Increment n_idx 
return 0 




Method: 


BOOL isKeyframe(long frame) ! 


Input: 


long frame 


Output: 


BOOL 


Description: 


Returns true if key frame 


Pseudocode: 


If frame number is less than 0 

Set frame = 0 
end if 

if there is no video index 

return i to avoid looping on waiting for a keyframe 
end if ; 
return key frame flaa 




Method: 


Int Open(char *lpFilename, int type) 


Input; 


char *lpFilename, int type I 
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Output: 


Int 


Description: 


Tries to oocri an AVI with and without an index 


Pseudocode: 


If IpFilename exists 




create new InpatMedia Class for data readiug 




CiQis? rv^Luiii djj^Ji u|j>i laic ttiiv/i vUUwi 




end if 




11 lilts Wdi llul vjpciJCti i t/sAljf 




delete input 




return 0 




end if 




miLuiiizc v mcu pos 




initialize audio__posc 




initialize audio_posb 




initialize i«\ 




initialize yideo^index 




initialize audio_index 




it input is not ok 








initialize input 




return 0 




end it 




Keaa encoded neaaerTrom Aireaay upenea me 




v^riiecK ior 1 eaaing errors, 




if error return 0, 




Get Encryption parameters from executable file* 




Vorin/ Tito it? airtKonf 11^ (Yi ^ rl i 

vpruy inu •>> auuiisiiLiL. c^umc rue. 




If error return 




"Rr»sH T-fraH^r 1 (rArti incirft* PCit\A file 
ivuuu ntauti iilmii uiaiuc ovjivi iiic 








uecrypi rtcaucr. 




venry ricducr 




il error revuiu 




jll.au ovi. 1 m uu-intv vjvwt'io, 




Extract Number of files. 




Check if this is the first time reading this file. 




11 iirsi ume 




Create Track index structure (Linked List) 




End if 




Select Track for reading. 




Verify the Track Number is valid. 




If error return 




Create memory structures for decrypting AVI file 




Commence Decompression/Decryption of AVI 




Record the length of the AVI file 




Call TnputMedia SetAviReadMode with Encryption Parameters and AVI 




file details. 




Tidy up temporary structures used for extraction. 




Tidy up temporary structures used for deletion 




if its an AVI 




ifthis->FiHHeader(I) 
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return 1 

else 

seek input 
IsAVIO 

Ifthis^FillHeader(0) 
return 1 

end if 

end if 

end if 
return 0 








Method: 


Int VideoStreamsO 


input: 


None 


Output: 


Int 


Description: 


Returns the total number of video streams 


Pseudocode: 


return video strn 




Method: 


Int AudioStreamsO 


Input: 


None 


Output: 


Int 


Description: 


Returns the total number of audio streams 


Pseudocode: 


return this->audio strn 




Method: 


intWidthO ! 


input: 


None 


Output: 


Int 


Description: 


Returns the video width 


Pseudocode: 


return width 




Method: 


Int HeightQ 


input: 


None 


Output: 


Int 


Description: 


Returns the video height 


Pseudocode: 


return height 




Method: 


BITMAPINFOHEADER *BitmapInfoHeader() 


Input: 


None 


Output: 


BITMAPINFOHEADER * 


Description: 


Returns the bitmapinfoheader associated with the first video 
stream. 


Pseudocode: 


return bitmapinfoheader 
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Method: 


Int FrameSi2e(unsigned long frame number) 


Input: 


unsigned long frame number 


Output: 


Int 


Description: 


Gives the size of a particular frame 


Pseudocode: 


If video Jndex docs not exist 
return -1 

end if 

if framejmmber is smaller then 0 
or framejiumber is greater or equal to videogames 
return -1 

end if 

return frame length 




Method; 


Double FrameRateQ 


Input; 


None 


Output: 


Double 


Description: 


Return the framerate 


Pseudocode: 


If frames per second equals 0 

frames per second is 25 

end if 

if frames per second equals 23 
frames per second is 25 

end if 

return frames per second 




Method: 


Long TotalFramesO 


Input: 


None 


Output: 


Long 


Description; 


Returns number of video frames 


Pseudocode: 


return thisvideo frames 




Method: 


Int NextVideoFrame(char *buffer) 


Input: 


char *buffer 


Output: 


Int 


Description: 


Reads the next video Frame into buffer, return the actual size of 
the frame. 


Pseudocode: 


If video index exists 

return -1 
end if 

if video_pos is smaller then 0 or videoj?os greater 
or equal to video frames 

return -2 
end if 

Request the mutex for reading the file 
Release the Mutcx 
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Method: 


int AviDecaps:;ReadAudio(char *audbuf, inf. bytes) 


Input: 


Long 


Output: 


Int 


Description; 


Seek to a particular video frame. 


Pseudocode: 


If audio index does not exist 

Error "No audio index" 

return -I 
end if 

Request the read Mutex 

loop until parsed enough chunks for the amount we want 

release the read Mutex 
end loop 
return nr 




Method: 


Int VideoSeek(lon£ frame) 


Input: 


Long 


Output: 


Int 


Description: 


Seek to a particular video frame. 


Pseudocode: 


If videojndex exists 
return -1 

end if 

if (frame is smaller than 0 ) frame equals 0 
video_pos equals frame 

end if 
return l 




Method: 


Int AudioSeek(long bytes) 


Input: 


Long 


Output: 


M 


Description: 


Seek to a particular audio . 


Pseudocode: 


If audio index does not exist 

return -1 
end if 

if bytes is less then 0 

bytes equals 0 
nO equals 0 

n 1 equals this->audio_chunks 
while nO is smaller then nl - 1 

work out position 
end while 

if audio length is greater than 1000 
work out audio__posb 

else 

audio __posb equals 0 
end if 
return 0 



Method: 



Int NextKeyFrameQ 
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Input; 


None 


Output- 


Int 


Description: 


Works out next key frame 


Pseudocode: 


increment video j>os 

whlle( not a key frame and haven't reached die end) 

increment video j>os 
end while 
return I 




Method: 


int PreviousKeyFrameQ 


Input; 


None 


Output; 


Int 


Description: 


Works out previous key frame 


Pseudocode: 


Decrement video jjqs by two 

(since we read the last frame) 
while not key frame and haven't reached the beginning 

decrement video_pos 
end while 
return I 




Method: 


Int Seek(int percent) 


Input: 


None 


Output: 


Int 


Description: 




Pseudocode; 


Compute the desired frame number 
Go to the next keyframe 
Set video position 

If there are more then one audio stream 
Calculate what ratio it corresponds to 
Set audio position 
return 1 

end if 

return 1 




Method: 


Int ReSeekAudioO 


Input; 


None 


Output: 


Int 


Description: 


Seeks Audio 


Pseudocode: 


If there are more than 0 AudioStreams 

WaitForSingleObject(this->hTOMutcx, INFINITE) 
Calculate what ratio it corresponds to set audio position 

End if 

Return 1 




Method: 


WAVEFORMATEX *WaveFormatExO 


Input: 


None 
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Output: 


WAVEFORMATEX * 


Description: 


Returns the wavefromatex associated with the first audio stream 


Pseudocode: 


return &thi$->waveformatex 




Method: 


Double GetProgressO 


Input: 


None 


Output: 


Double 


Description: 


Return progress 


Pseudocode: 


return (double) ((double)(this->video pos"))*100-O/((doubic)ihis^>video frames) 




Method: 


int GetBufferingStateQ 


Input: 


None 


Output: 


Int 


Description: 


Returns buffer state 


Pseudocode: 


If input does not equal to NULL 
return buffer state 

end if 
return 0 




Method: 


int CloseO 


Input: 


None 


Output: 


Int 


Description: 


Closes and frees all memory allocations no longer required 


Pseudocode: 


If input exists 

Close input 
delete input 

initialize input to NULL 

end if 
if idx exists 

free idx 

end if 

if video Jndex exists 

free videQ_ind<2x 

end if 

if audio_index exists 

free audio_index 

end if 
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CLASS NAME: 
Playback 

DESCRIPTION: 



ATTRIBUTES: 

Windows interface variables. 
10 &JiInstance 
hWnd 

Application state variables 

g_bActive 

gJt>Ready 
15 State of playback variables 

MediaChanging 

FirstTimePlayed 

playing 

paused 
20 fullscreen 

PlayBackFailed 

Requested volume 

volume 

NoSound 
25 Synchronising variables 

pausedticks 

baseTime 

stopTinie 

DisplayTimes (DISPLAYS AMPLES] 
30 Track changing variables 

TrackChangingTimcr 

NextTrack 

TrackChangePaused 

CurrentlyPlayingTrack 
35 ResetPositionFlag 

Track selection variables 

Tracklndex 

TrackTitlelndex 

SingleTrackOnly 
40 User Interface variables 

MouseDraggingSlidcr 

CurrentSliderPosition 

Summation statistics 

video_framcs 
45 displayedjfranics 
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audio^bytes 

User requested screen size 
WindowRe$oIution_x 
WindowRe$oIiition_y 
5 Error function variables 
WindowTitle 
ErrorCodc 
ErrorMessage 

Access to other class variables 
10 videoRenderer 
audioRenderer 
decaps 
codec 

itudioCodec 
15 vidcoBuffer 

CDROM eject detection variables 
FilcDrivcLetter 



20 METHODS: 



Method: 


Playbac^Wmdow* Size_x, Si*e_y, hlnst, CMDLine, 
TheSingleTrackOnly, FirstTime) 


Input: 


As above 


Output: 


None ; 


Description: 


Default constructor. Initialises all base variables used in playback 
class 


Pseudocode: 


initialise WindowResolution = Size 
initialise MediaChanging 
initialise WindowTitle to "Egenie Player" 
initialise CurrentlyPIayingTrack 
initialise videoRenderer 
initialise fullscreen to not Window 
initialise WindowResolution_x to Size_x 
initialise WindowResolution_j to Size_y 
initialise PlayBackFailed 
initialise volume 

initialise SingleTrackOnly to TheSingleTrackOnly 
initialise FirstTimePlayed to FirstTime 
initialise MouseDraggingSlider 




Method: 


ConstructorO 


Input: 


As above 


Output: 


None 


Description: 


Default constructor. Initialises all (per) instance variables used in 
playback class 
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Pseudocode: 


initialise g_bActive 
initialise g^bReady 
initialise WindowTitie 
initialise codec 
initialise decaps 
initialise audioCodeo 
initialise audioRenderer 
initialise playing 
initialise paused 
initialise NoSound 
initialise TrackChangingTimer 
initialise TrackChangePause 
initialise Tracklndex 
initialise TrackTitlerndex 
initialise ErrorCode 
initialise ErrorMcssage 
initialise DisplayThncs 




Method: 


PlaybackO 


Input: 


None 


Output: 


None 


Description: 


Delete and free all memory associated with Playback class 


Pseudocode: 


If the videoRenderer exists and not windowed, switch to windowed j 

mode. 
Hide the main window 

Safely delete the audiorenderer. i 
Safely delete the videoRenderer. 
Safely delete the codec. 
Safely delete the decaps. 
Safely delete the audioCodec. 




Method: 


Int CioseO 


Input: 


None 


Output! 


Int 


Description: 


Delete and free all memory associated with Playback class, 
that is not required for track changing. 


Pseudocode: 


Safely delete the audiorenderer^ but first remember the volume setting. 

Safely close the videoRenderer* 

Safely delete the codec. 

Safely delete the decaps. 

Safely delete the audioCodec. 

Set MediaChanging to true 

Safely delete the Track index 

Safely delete the track title index. 

Return ok 




Method: 


void HandleErroKcliar * WindowTitie) {} 


Input: 


char * 
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Output: 


void 


Description: 


The error handler for the windows functions. Display a message to 
the user and return. 


Pseudocode: 


Set PlayBackFailed to true 

Tf error was a subcode, instantiate the required handier for the correct class. 
Make sure to remove fullscreen mode prior to attempting to display a message 
box. 

Tell the user about the fault. 




Method: 


int MtApplication(HINSTANCE hlnstance, int nCmdShow) 


Input: 


HINSTANCE, int 


Output: 


int 


Description: 


Do work required for every instance of the application: 
Create the window, initialize data 


Pseudocode: 


Calculate the proper size for the window, 

given a client of Scrcen_si2e_X and Screen_size_y 

Check for windowed mode. 

ff non windowed, don't worry about the TOPMOST setting 

Create a window for WINDOWED MODE 

Save the window handle for future use 

If the window handle was invalid, store error and return error. 

Return ok 




Method: 


int Open(lpFilename, type, hlnstance, TrackToPlay, MedTit) 


Input: 


As above 


Output: 


int 


Description; 


Opens file IpFilename for playback, sets up all variables 


Pseudocode: 


Call constructor 

If a fdename doesn't exists then 

Create a videorenderer. 

If error store error, handle error and return. 

Call video Tenderer constructor. 

Call initapplication 

If error store error, handle error and return. 

Call init the video renderer. 

If error store error, handle error and return. 

Call display Video Infonnation 

Return ok 

End If 

Create decaps structure with filename 

if error store error, handle error and return. 

Open decaps structure. 

If error store error, handle error and return 

Store currently playing track 

Store all track titles. 

Get the drive letter where the media is being executed from. 
Store for later Media ejection test 
Create audloCodec structure with filename 
If error store error, handle error and return. 



WO 03/005190 



PCT/AU02/00922 



-78- 




Check AudjoCodec 




If error set no sound to true. 




If not MediaChanging and the videoRenderer is non existant 




Create videoRenderer structure 




Tf error store error, handle error and return. 




End If 




Call Constructor for the videoRenderer 




If not NoSound, create the audioRenderer 




if error store error, handle error and return. 




if not Media changing then initApplication 




If sound then 




Set up AudioRenderer. 




If trivial error, set no sound to true and continue 




Else store error, handle error and return 




End if 




Initialise the videoRenderer 




Tf error store error, handle error and return. 




Create codec structure 




If error store error, handle error and return. 




Verify the codec is ok 




If error store error, handle error and return. 




Set playing and paused to false 




Create videoBuffer structure 




If error store error, handle error and return. 




Initialise the videoBuffer 




If error store error, handle error and return. 




Set Media changing to false 




Return ok 



Method: 


unsigned long VideoTimeO 


Input: 


None 


Output: 


unsigned long 


Description: 


Return the current video time in ms 


Pseudocode: 


If decaps exists and frame rate does not equal to 0 
return (unsigned long) 
video_fraines * 1000.0 / FraineRate 

else 

return 0 

end if 




Method: 


Int GetTimeO 


Input: 


None 


Output: 


Int 


Description: 


Gives Global Time 


Pseudocode: 


return VideoTime/1000 




Method: 


Int GetTotalTimeO 


Input: 


None 
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Output; 


Int 


Description: 


Gives Global Time 


Pseudocode: 


If decaps structure exists 
return total frames / frame rate 




Method: 


int WidthQ 


input: 


None 


Output: 


int 


Description; 


Returns the video width 


Pseudocode; 


If decaps exists 

return width of video 

end if 




Method: 


IntHeightO 


Input: 


None 


Output: 


int 


Description: 


Returns the video height 


Pseudocode: 


If decaps exists 

return height of video 

else 

return 0 

end if 




Method; 


BOOL isPausedO 


Input; 


None 


Output: 


BOOL 


Description: 


Returns if playback is paused or not 


Pseudocode: 


return paused variable 




Method: 


int Play(IgnoreQuality) 


Input: 


Ignore quality message 


Output: 


int 


Description: 


Plays file 


Pseudocode: 


If already playing then return ok 

Set playing to true and paused to false 

Initialise videojrames 

Initialise displaycdjframes 

Initialise audio_bytes 

Start the Video Buffer 

Perform the timing calculations here to determine how good the presentation 
will be 

If quality is not not ignored 

Get information from AudioCodec> videoBuffer, InputMedia, decaps 
and determine if it is marginally or worse slower. 

If it is switch the videoRenderer to fullscreen and calculate die 
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time to render a frame. 




Adjust to timing calculation with rendering time, and determine 




quality of video playback. 




Report quality message to user, if appropriate 




End if 




JF sound is available, start the audiorenderer. 




If error, store error, handle error and return. 




Show the playback window 




Return ok 



Method: 


int ResumeO 


Input: 


None 


Output: 


int 


Description: 


Unpau$es playback 


Pseudocode: 


Hide the mouse cursor 
If seeking then 

If audio then reseek the audio 

If error, store error, handle error and return. 

End if 
If audio 

Resume the audio 

If error, store error, handle error and return 

End if 

Restart the Video 

Reset the synchronising of the video. 
Set flag to wipe back buffer. 




Method: 


int PauseO 


Input: 


None 


Output: 


Int j 


Description: 


Pause the Playback Stream 


Pseudocode; 


Safely pause the audio Rcnderer 
Safely pause the vidcorenderer. 
Draw the drag and drop bar. 
Set Cursor to standard cursor. 

Set seek flag to not. j 
Return ok 




Method: 


int ShowPlayBackWindow () 


Input: 


Type to display 


Output: 


int 


Description: 


Updates the screen according to request. 


Pseudocode: 


Hide, show, or update overlays depending on the programs request 




Method: 


int PlayFrame(void) 


Input: 


None 
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Output: 


int 


Description: 


Displays a frame, and performs the synchronising. 


Pseudocode: 


Get current time difference between audio and video. 

Estimate time required to display the next frame. 

Check if the audio is running ahead of the video. 

If audio is considerably ahead, drop frames to catch up. 

If audio is considerably behind, wait 

Else Start processing a frame 

Get frame from video buffer 

If error, store error, handle error and return. 

Increment frames played 

Check if it was the last frame, if so return Lastjrame 
If not 

If paused return ok 

Pass the frame to the video renderer 

If error, store error, handle error and return. 

Update synchronising variables 

End if 
Return ok 




Method: 


int SwitchFullScreen 0 


Input: 


None 


Output: 


int 


Description: 


Switch the video Renderer between windowed mode and fall 
screen.. 


Pseudocode: 


If video renderer is ok, 

Call change coop level on video renderer 
If error, store error, handle error and return, 

Else if 

store error, handle error and return. 

End if 
Return ok 




Method: 


int PaintLastFrame () 


Input: 


None 


Output: 


int 


Description: 


Updates the screen with the last frame. 


Pseudocode; 


If video renderer is ok, 

Call update frame on video renderer with last frame 
If error, store error, handle error and return. 

Else if 

store error, handle error and return. 

End if 
Return ok 




Method: 


int AreThreadsHealthy 0 


Input: 


None 


Output: 


int 
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Description: 


Tests if all threads are still processing. - 


Pseudocode: 


If playback felled return feult. 

If audioRenderer thread is failed and sound is required return fault 
If sound had stalled, set no sound is required, and continue, 
Tf Input reading thread is failed, return error 




Method: 


int DrawSelectionBar 0 


Input: 


None 


Output: 


int 


Description: 


Draws the slider bar on the screen. 


Pseudocode- 


Generates the text for the mouse slider bar, and displays It on the screen. 
Return ok 




Method: 


intlnsideAHBounds 0 


Input:' 


Input rectangle 


Output: 


Int 


Description: 


Verify if the mouse cursor is with the specified rectangle. 


Pseudocode; 


Return true if the above is true 




Method: 


int Seek 0 


Input: 


Percentage 


Output: 


int 


Description: 


Reseeks the triedia. 


! Pseudocode: 


Set cursor to waiting cursor. 

If first seek while paused, then kill input thread 

Seek the decaps 

Update the video position 

Start the video buffer 

Paint the last frame 

Redraw the selection bar 

Set cursor to normal cursor 

Return ok 




Method: 


int PlaybackWindowProc 0 


input: 


Standard windows messaging functions. 


Output- 


int 


Description: 


Handles the windows messages for the window. 


Pseudocode; 


In case of particular message do, 
If Activate Message, then 

Set app to inactive, or active depending on request. 

End If 

If Command Message, then 

If switch ALT-ENTER message 
Pause the video. 

Switch between window and fullscreen 
Resume the video 
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End If 




1M1U 11 




11 lesizc message 




Tf fiiHQPrppn hrpnlr 




T7 ] na mnvp Hrt Tint mSIZft 
DISC lilvYC VVUIUVVr, llVl iwsm" 




Fnd If 

CUU 11 




II close niessage 




Qpf nl TV/hark failpd flnrf rcL'Ufrt 




rj_ _i 




If destroy message 




oCt piayOuCK. ItlLLCU duU rCLUfil 




cna ll 




li leit ciiCK aowii message 




11 not paused return 




df*t mnrrHnatps nf slider and bar 




Tf inciHp ^iTHprftnr 




it msioe snoer 




Set mnnv HraO'i^inCr «?lidcr tO true Slid return* 




C n J If 

cno it 




oeeK tne pjayDacK. 




bna it 




bna it 




If mouse move message 




ma^pa it? flf atY/vino cIiHpr rAHt**iiv clirlpv in rtnrrpp.t location 

it mouse is dragging Miucr, reuraw miuci m i/uu^i lyvauuu. 




End If 




If left click up message 




(f mroicA ic rh^ifTcrinfT cliHpi* <jppIt viHpo to np.W location 




End If 




tf Iran »*»».ar»r , A/1 tnaeenffA 

li key pressea message 




11 space (Ml 




Pnn^p or refinnB as necessarv 




Fnrt if 




Tf pcr-nnp 




Ret nlavback failed and return. 




FnH if 

Cllll 11 




If up 




If sound available increase volume. 




End if 




If down 




If sound available decrease volume. 




End if 




Ifleft 




Tf appropriate, pause video and display start of track. 




Else if subsequent press> display prior track. 




Update screen accordingly 




End if 




If fight 




If appropriate* pause video and display next track. 




Else if subsequent press, display next track. 




Update screen accordingly 




End if 




End If 




If re paint screen message 
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If paused, repaint the last frame and draw the selection bar. 




Else, wipe the back buffer if appropriate. 




End If 




(f device Change message 




Check if our media has been removed. If so, fail playback 




and exit accordingly 




End if 




Ff set cursor message 




Clear cursor if paused. 




End If 




If move message 




Move the window to new location. 




End If 




If system menu messages 




Return and don f t process 




£nd if 




End if 




Return ok 
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CLASSNAME; 
SplashScreen 

DESCRIPTION: 

Displays the starting screen and the ending screen for the application. 

ATTRIBUTES: 

End Screen Variables 

NoListBox 

SingleTrack 

bSpIashScreen 

StartUpTicksCounter 

Return Value 

Replay 

Windows Interface variables 
hlnst 

OldCursor 

URLFont 

TheWindow 

List Box contents 
WtedTit 

Component Variables 

OldCursorValid 

Visited_Egenie 

Visited_CHent1 

Visited_CHent2 

URL_AddressOffline 

URL_AddressOnline 

URL^String 



METHODS: 



Method: 


SplashScreen (IsSptash, hi, * MediaTitles, URL Link) 


Input: 


As above 


Output; 


None 


Description: 


Splash Screen Class constructor 


Pseudocodei 


Store MediaTitles 




Initialise ThisSplashScreen 




Initialise TheWindow 




Initialise Replay 




Store IsSplash 




Store hi 




Initialise NoListBox 




Initialise OldCursor 




Initialise OldCursorValid 




Initialise URLFont 




Initialise Visited ERenie 
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Initialise VisitedClientl 




Initialise Visited_CIient2 




Initialise URL_AddressOnline 




Initialise URL_AddressOffline 




Initialise URL~String 




Parse the URL Link and separate into components. 



Method: 


~ SplashScreen 0 


Input; 


None 


Output: 


None 


Description: 


SplashScreen destructor class, frees all memory used by 
SplashScreen 


Pseudocode: 


Ends dialog if necessary 
Delete fonts 
Delete new strings 




Method: 


IsMouseOverWindow (This Window) 


Input: 


A window 


Output: 


boolean 


Description; 


Returns true or false, if a mouse is over a window. 


Pseudocode: 


Get Cursor point 

Check if inside window bounds 

Return true if so, else return false 




Method: 


int Show () 


Input; 


HWnd- Parent, In SingleTrack 


Output: 


int 


Description: 


Creates the dialog as required.. 


Pseudocode; 


Store In_SingleTrack 
Start Timer 

if it is a splash screen then 

Create the dialog (modeless) 
Process all pending messages. 

Else if 

Create the dialog (Modal) 

End if 
return 




Method: 


MainDlgProc 0 


Input: 


Standard Windows Processing 


Output: 


boolean 


Description; 


Processes ail splash screen window handling. 


Pseudocode: 


Jn case of particular message do, 
If first starting 

Call init dialog 

End If 
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ix uxsJL, Lcxif iiignugni 3S required anci hiokc DaCKgruLuiu 




iransparcni 




bna it 




If mouse move 




Check if a URL object is being passed over. 




If so, set cursor to a hand. 




If not set to default cursor 




End If 




If setting cursor is required. 




Set cursor according to function above. 




End If 




If Left Button Down 




Check if link has been pressed, if so 




Get details of current program, application name, drive letter 




Call HttpCheck and find if user is online. 




Jump to Online URL if online 




Jump to Offline URL if offline. 




hno. It 




If Command then 




If cancel 




End Dialog 




End If 




if replay 




Set correct exit code 




End Dialog 




End Tf 




If track selection 




If double click, set exit code, and close dialog 




End If 




End If 




Default- return ok 




End case 



Method: 


OnlnitDialog 0 


Input: 


None 


Output: 


None 


Description: 


Initialises all class variables for the dialog. 


Pseudocode; 


If it is the: end dialog then 
Centre the window 
Populate die track selection box 
Hide it if single track, or track and logo 
Create the font for the URLs 
And attach to dialog box 

End If 
Return ok 




Method: 


int Wait () 


Input: 


Milliseconds 


Output: 


Int 


Description: 


Wailis a certain number of milliseconds before continuing. 
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Pseudocode: 1 If time hasn't expired, the sleep for the remaining time. 



Method: 


URL Encode (InBuffer, QutBufifer) 


Input: 


As above 


Output: 


boolean 


Description: 


Encode a string for URL usa^e. 


Pseudocode: 


Parse the input buffer, and return details to the output buffer. 



Method: 


int HttpCheck() 


Input: 


DNS name to ping 


Output; 


int 


Description: 


Determines if the online URL web site is available. 


Pseudocode: 


Open Windows socket system 
If error return Internet Unavailable 
Look up domain name to obtain IP address 
If error return Internet Unavailable 
Attempt connection to server at port 30 
If error return Internet Unavailable 
Retum Internet OK 
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PROGRAM NAME: 

Main Windows start up function 

DESCRIPTION: 

Displays the starting screen and the ending screen for the application. 

GLOBAL VARIABLES: 

URL Link 
Playback class 
Accelerator Interface 
Splash Screen Class 



FUNCTIONS: 



Method: 


WindowProc () 


Input: 


Window Messaging Call back variables. 


Output: 


long 


Description; 


Main Window default message handler 


Pseudocode: 


Lf the playback doesn'r exist, don't process the messages. 
Else pass to playback class.. 




Method: 


WmMairt 0 


Input: 


Window Application variables. 


Output: 


int 


Description: 


Main Program 


Pseudocode: 


Initialise running variables. 

Increase the process priority to be higher than director 
Set error mode for the program to catch critical errors 
Call Handle the command line if fails, exit program 
Complete setting up of variables. 
Call InitApplication if failed exit program 
If a splash screen is required, 
Create splash screen 

If error then exit program 

Show splash screen 

End If 
RERUN: 

If Playback class doesn't exit 

Create new playback with command line variables 

End If 

Open the playback. 

If error, exit program 

If a splash screen is required, 

Wait for 3 seconds 

Delete the splash screen 

End If 

Start Windows Message Processing loop. 
If message 

get message. 

Translate accelerated message 
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Dispatch Message 




it piayoacK tailed, exit loop 




Else If 




if app active and visible 




If feiled exit Iqop 




Play a frame 




If error exit loop 




Check threads are healthy 




If error exit loop 




If video finished, prepare for next track and exit 




loop. 




Else If 




If waiting while track changing 




Check if track changing timer has 




finished. 




If so jump to next track (or continue) 




Else If 




Wait for next windows message. 




End If 




End If 




End If 




End loop 




if changing track then go to rerun 




Delete the playback structure 




If an execute string is present, execute it and exit. 




If the end dialog is required 




Create the end screen 




Run tile end screen 




If return result is error, exit program 




If rerun, jump to rerun 




If rerun clip renin that clip. 




End If 




Clean up allocated variables and exit program. 



Method: 


HandleCommandLine 0 


Input: 


Command line variables 


Output: 


int 


Description: 


Handle the command line variables 


Pseudocode: 


Parse the command line execute with the program. Convert to upper case for 
switch options, and collect the following details; 
(all optional) 

/quality - is a performance message required. 

mosplash - is no splash screen required 

/noend - is no end dialog required 

/singletrack - play one track, and one track only 

/url - pick up message, online URL string and Offline URL string, 

/run - execute this program when finished 

/window - don't play full screen, but in a window 

/size xxx x yyy - required screen display resolution. 

/track - which video clip to play 
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Method; 


InitApplication 0 


Input; 


HINSTANCE. 


Output; 


int 


Description: 


Application registering for windows 


Pseudocode: 


Create and register a windows class for this application. 
Load short cut accelerators 
Return success 



Although the salient features, functions and arrangements of the an 
implementation of the present invention have been presented hereinabove, the description is 
5 not exhaustive, and those of ordinary skill in the art will recognise that many modifications 
and additions can be made to what has been described without departing from the spirit and 
scope of the present invention. Accordingly, the present invention is intended to embrace all 
such alternatives, modifications and variations that fall within the spirit and broadest scope 
of the appended claims. All publications, patents and patent applications mentioned in this 

10 specification are herein incorporated in their entirety by reference into the specification, to 
the same extent as if each individual publication, patent and patent application was 
specifically and individually indicated to be incorporated herein by reference. In addition, 
citation or identification of any reference in this application shall not be construed as an 
admission that such reference is available as prior art to the present invention. Further, 

15 citation or identification of any reference in this application shall not be construed as an 
admission that any disclosure therein constitutes, or would be considered by an ordinarily 
skilled artisan in the field of the invention to constitute, common and/or general knowledge 
in the field, 

20 Throughout this specification, unless the context requires otherwise, the word 

''comprise", or variations such as "comprises" or "comprising", will be understood to imply the 
inclusion of a stated integer or group of integers but not the exclusion of any other integer or 
group of integers. Furthermore, the foregoing detailed description of an implementation of the 
invention has been presented by way of example only, and is not intended to be considered 

25 limiting to the invention which is defined in the claims appended hereto. 
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Claims 

L A method for providing multimedia presentation by way of a computer 

processing and display apparatus having a data reading device for reading data from a 
5 removable digital data storage carrier, such as an optical data storage disk or the like, wherein a 
removable data storage carrier i$ provided having stored thereon at least one multimedia 
content data file in a compressed format, together with computer program code for execution 
on the computer processing and display apparatus and adapted for decompression of the at 
least one multimedia content data file and presentation of the multimedia content on the 

io computer processing and display apparatus, wherein the computer program code provided with 
the multimedia content data file on the removable data storage carrier includes a data 
decompression module adapted to decompress the associated multimedia content data file and 
a multimedia player module that receives decompressed data from the decompression module 
and presents corresponding multimedia content for output by way of the computer apparatus 

15 hardware, whereby the multimedia content of the associated data file is presented by the 
computer apparatus hardware through use of the computer program code upon insertion of the 
removable data storage carrier in the data reading device and execution of the computer 
program code. 

20 2. A method as claimed in claim 1, wherein the multimedia content includes 

moving pictures video and audio. 

3. A method as claimed in claim 2, wherein the multimedia presentation 
comprises substantially full-screen broadcast quality video. 

25 

4. A method as claimed in claim 1, wherein the multimedia presentation is 
initiated automatically upon insertion of the removable data storage carrier in the computer 
data reading device. 

30 5. A method as claimed in claim 1, wherein the decompression and player 
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program code modules are executable on the computer processing and display apparatus 
without requiring installation with the computer operating system. 

6. A method as claimed in claim 5, wherein the player program module interacts 
5 directly with the decompression module and a hardware abstraction layer of the computer 

operating system in order to provide the multimedia content presentation. 

7. A method as claimed in claim 6, wherein the computer operating system 
comprises a Microsoft Windows™ operating system, and wherein the player program module 

10 is adapted to effect presentation of the associated multimedia content without reference to the 
operating system registry, 

8. A method as claimed in claim 1, wherein the at least one multimedia content 
data file is encoded with a digital key or the like, such that decompression and/or playing of the 

15 multimedia content is only possible utilising decompression and/or player program modules 
provided with a corresponding decoding key. 

9. A method as claimed in claim 8, wherein the decoding key is provided on the 
removable data storage carrier. 

20 

10. A method as claimed in claim 8, wherein the decoding key is provided 
separately for input to the computer apparatus by a user to enable presentation of the 
multimedia content 

25 1 1. A method as claimed in claim 10, wherein the decoding key is provided with 

packaging associated with distribution of the removable data storage carrier. 



30 



12, A method as claimed in claim 8, wherein the decoding key is provided to the 

computer apparatus by way of a digital communications network, such as lhe internet or a 
corporate intranet 
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13. A method a$ claimed in claim 12, wherein the decoding key is transmitted to 
the computer apparatus from an authorisation server in response to information provided by a 
user. 

5 

14. A method as claimed in claim 13, wherein the user provides information for 
initiation of an electronic commerce transaction, in response to which the decoding key is 
transmitted, 

10 15. A method as claimed in claim 8, wherein the validity of the decoding key i$ 

time limited, whereby presentation of the multimedia content with the decoding key is only 
possible over a predetermined time period. 

16. A method as claimed in claim 8, wherein the validity of the decoding key is 
1 5 limited to a predetermined number of instances of the multimedia content presentation. 

17. A method as claimed in claim 2, wherein the video display presentation 
includes at least one display region that is user selectable by way of a pointing device, such as a 
computer mouse or the like, to cause the player program module to perform at least one 

20 corresponding predetermined action. 

18. A method as claimed in claim 17, wherein the at lea$t one corresponding 
predetermined action relates to control of the video playback presentation. 

25 19, A method as claimed in claim 17, wherein the at least one corresponding 

predetermined action comprises presentation of information obtained by way a digital 
communications network transmitted to the computer apparatus in response to the user 
selection. 



30 20. 



A method as claimed in claim 1, wherein the removable data storage carrier 
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comprises a computer readable compact disc (CD-ROM), 

21. A method as claimed in claim 1, wherein the multimedia content data file is 
compressed according to MPEG-4 encoding. 

5 

22. A computer readable, removable digital data storage carrier having stored 
thereon at least one multimedia content data file in a compressed format together with 
computer program code foT execution on a computer processing and display apparatus to 
decompress the at least, one multimedia content data file and present the multimedia content on 

10 the computer processing and display apparatus, wherein the computer program code provided 
with the multimedia content data file on the removable data storage carrier includes a data 
decompression module adapted to decompress the associated multimedia content data file and 
a multimedia player module that, during execution on the computer apparatus, receives 
decompressed data from the decompression module and presents corresponding multimedia 

15 content for output by way of the computer apparatus hardware, whereby the multimedia 
content of the associated data file is presented by the computer apparatus hardware through use 
of the computer program code upon insertion of the removable data storage carrier in the data 
reading device and execution of the computer program code. 

20 23. A computer readable, removable digital data storage carrier as claimed in claim 

22, wherein the decompression and player program code modules are executable on the 
computer processing and display apparatus without requiring installation with the computer 
operating system. 

25 24, A computer readable, removable digital data storage carrier as claimed in claim 

23, wherein the player program module is adapted to interact, during execution, directly with 
the decompression module and a hardware abstraction layer of the computer operating system 
in order to provide the multimedia content presentation. 



30 25. 



A computer readable, removable digital data storage carrier as claimed in claim 
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24, wherein the player program module is adapted to effect presentation of the associated 
multimedia content without reference to the operating system registry of a Microsoft 
Windows™ operating system. 

5 26. A computer readable, removable digital data storage carrier as claimed in claim 

22, wherein the at least one multimedia content data file is encoded with a digital key or the 
like, $uch that decompression and/or playing of the multimedia content is only possible 
utilising decompression and/or player program modules provided with a corresponding 
decoding key. 

10 

27. A computer readable, removable digital data storage carrier as claimed in claim 
26, wherein the decoding key is provided stored on the removable data storage carrier, 

28. A computer readable, removable digital data storage carrier as claimed in claim 
1 5 26, distributed with packaging providing said decoding key. 

29. A computer readable, removable digital data storage carrier as claimed in claim 
22, wherein the removable data storage carrier comprises a computer readable compact disc 
(CD-ROM), 

20 

30. A computer readable, removable digital data storage carrier as claimed in claim 
22, wherein the multimedia content data file is compressed according to MPEG-4 encoding, 

31* A computer having multimedia presentation capabilities operating under 

25 control of an operating system, in combination with a computer program that is executable on 
said computer to provide a multimedia presentation using an associated encoded media data 
file without requiring installation of the computer program with the operating system, 

32. The combination of claim 31, wherein the computer program includes a 

30 decompression program module for decompressing media data from the encoded media data 
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fde, and a player program module that in use interacts directly with the decompression module 
and a hardware abstraction layer of the computer operating system in order to provide the 
multimedia content presentation, 

5 33. The combination of claim 32, wherein the computer operating system 

comprises a Microsoft Windows™ operating system, and wherein the player program module 
is adapted to effect presentation of the associated multimedia content without reference to the 
operating system registry. 

10 34. The combination of claim 31, wherein the multimedia presentation comprises 

substantially full-screen broadcast quality video* 

35. The combination of claim 34, wherein the computer program is provided stored 
on a removable data storage carrier, such as an optical digital storage disk or the like, together 

1 5 with at least one associated encoded media data file. 

36. A computer program in machine readable form and executable on a computer 
operating under control of an operating system, the computer program including a decoding 
program module for decoding media data from an associated encoded media data file, and a 

20 player program module for processing the decoded media data and controlling the computer to 
provide a video display presentation of the decoded media data, wherein the computer program 
is executable widiout requiring installation under the computer operating system. 

37. A computer program as claimed in claim 36 ? including at least one encoded 
25 media data file. 

38. A computer program as claimed in claim 37, wherein at least one 
corresponding digital key is required by the decoding program module in order to effect 
decoding of each encoded media data file. 



30 
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39. A computer program as claimed in claim 38, including a user input function by 

which a user may provide a digital key to enable decoding of an encoded media data file and 
subsequent playback of the corresponding video display presentation, 

5 40. A computer program as claimed in claim 38, including a communications 

program module by which the computer program may receive, by way of a digital 
communications network, a digital key to enable decoding of an encoded media data file and 
subsequent playback of the corresponding video display presentation. 



10 



4L A computer program as claimed in claim 37, wherein the computer program 

executable modules and at least one encoded media data file are stored for distribution on a 
removable digital data storage carrier, such as a computer readable compact disk or the like. 
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